Skip to content

option_list_expirations

FreeValueStandardPro

List all available expiration dates for an underlying symbol. This is typically the first call in an option chain discovery workflow.

Code Example

rust
let data = tdx.option_list_expirations("SPY").await?;
for item in &data {
    println!("{}", item);
}
python
data = tdx.option_list_expirations("SPY")
for item in data:
    print(item)
typescript
const data = tdx.optionListExpirations('SPY');
console.log(data);
cpp
auto data = client.option_list_expirations("SPY");
for (const auto& item : data) {
    printf("%s\n", item.c_str());
}

Parameters

symbolstringrequired
Underlying symbol

Response

(list)string[]
Expiration date strings in YYYYMMDD format

Sample Response

json
["2012-06-01", "2012-06-08", "2012-06-16", "...", "2028-12-16", "2029-01-19"]

SPY has 2,000+ expirations spanning from 2012 to 2029. Shown cropped.

Notes

  • Returns all expirations including weeklies, monthlies, and quarterlies.
  • Combine with option_list_strikes to enumerate the full chain for a given expiration.

Released under the Apache-2.0 License.