Contracts

FreeValueStandardPro

List all option contracts for a symbol on a given date.

Lists all contracts that were traded or quoted on a particular date.

If the symbol parameter is specified, the returned contracts will be filtered to match the symbol. Multiple symbols can be specified by separating them with commas such as symbol=AAPL,SPY,AMD This endpoint is updated real-time.

pub fn option_list_contracts(
    &self,
    request_type: &str,
    symbol: &str,
    date: &str,
) -> OptionListContractsBuilder<'_>

Optional parameters chain on the builder: .max_dte(i32). Execute with .await → Result<Vec<OptionContract>, Error>, or decode chunk-by-chunk with .stream(handler).

Example

let rows = tdx.option_list_contracts("trade", "SPY", "20250303").await?;
for t in &rows {
    println!("symbol={} expiration={} strike={} right={}", t.symbol, t.expiration, t.strike, t.right);
}

ThetaDataDxClient.option_list_contracts(
    request_type, symbol, date,
    *,
    max_dte=None, timeout_ms=None,
) -> OptionContractList

option_list_contracts_async(...) awaits the same call shape. Chain .to_pandas() / .to_polars() / .to_arrow() / .to_list() on the result.

Example

rows = tdx.option_list_contracts("trade", "SPY", "20250303")
for t in rows:
    print(t.symbol, t.expiration, t.strike, t.right)

optionListContracts(
  requestType: string, symbol: string, date: string | Date, options?: { ... },
): Promise<Array<OptionContract>>

Optional parameters ride in a single trailing options object: maxDTE?: number, timeoutMs?: number.

Example

const rows = await tdx.optionListContracts('trade', 'SPY', '20250303');
for (const t of rows) {
  console.log(t.symbol, t.expiration, t.strike, t.right);
}

std::vector<OptionContract> option_list_contracts(
    const std::string& request_type,
    const std::string& symbol,
    const std::string& date,
    const EndpointRequestOptions& options = {}) const;

Optional parameters chain on EndpointRequestOptions: .with_max_dte(...). Throws tdx::Error on failure.

Example

auto rows = client.option_list_contracts("trade", "SPY", "20250303");
for (const auto& t : rows) {
    std::cout << t.symbol << ' ' << t.expiration << ' ' << t.strike << ' ' << t.right << "\n";
}

GET http://127.0.0.1:25503/v3/option/list/contracts

Served by the bundled server binary; responses stream as JSON, CSV, or NDJSON via the format parameter.

Example

curl 'http://127.0.0.1:25503/v3/option/list/contracts?request_type=trade&symbol=SPY&date=2025-03-03'

Parameters

Name	Type	Required	Default	Description
request_type	string	yes	—	Request type. Accepted values: trade, quote, eod, ohlc.
symbol	string	yes	—	Ticker symbol (e.g. AAPL)
date	date	yes	—	Date YYYYMMDD
max_dte	int	no	—	Maximum days to expiration
timeout_ms	int	no	—	Per-request deadline in milliseconds. 0 means no deadline.

Response

Rows of OptionContract:

Field	Type	Description
symbol	string	Underlying symbol of the contract.
expiration	i32	Expiration date of the contract as a YYYYMMDD integer.
strike	f64	Strike price of the contract in dollars.
right	string	Contract right: 'C' for a call, 'P' for a put.