option_list_contracts

FreeValueStandardPro

List all option contracts available for a given underlying symbol on a specific date. Returns the full matrix of expirations, strikes, and sides.

Code Example

Rust

let contracts: Vec<OptionContract> = tdx.option_list_contracts("EOD", "SPY", "20240315").await?;

Python

contracts = tdx.option_list_contracts("EOD", "SPY", "20240315")

Go

contracts, err := client.OptionListContracts("EOD", "SPY", "20240315")

C++

auto contracts = client.option_list_contracts("EOD", "SPY", "20240315");

Parameters

request_typestringrequired

Data type (e.g. "EOD", "TRADE")

symbolstringrequired

Underlying symbol

datestringrequired

Date in YYYYMMDD format

max_dteintoptional

Maximum days to expiration filter

Response

rootstring

Underlying symbol

expirationstring

Expiration date in YYYYMMDD format

strikestring

Strike price as scaled integer

rightstring

"C" for call, "P" for put

Notes

• Use max_dte to limit results to near-term expirations, which significantly reduces the result set for highly liquid underlyings like SPY.
• This is a bulk discovery endpoint. For targeted queries, use option_list_expirations + option_list_strikes instead.