Dates

FreeValueStandardPro

List available dates for an option contract by request type.

Lists all dates of data that are available for an option with a given symbol, request type, and expiration. This endpoint is updated overnight.

pub fn option_list_dates(
    &self,
    request_type: &str,
    symbol: &str,
    expiration: &str,
) -> OptionListDatesBuilder<'_>

Optional parameters chain on the builder: .strike(&str), .right(&str). Execute with .await → Result<Vec<String>, Error>.

Example

let rows = tdx
    .option_list_dates("trade", "SPY", "20250321")
    .strike("570")
    .right("C")
    .await?;
for value in &rows {
    println!("{value}");
}

ThetaDataDxClient.option_list_dates(
    request_type, symbol, expiration,
    *,
    strike=None, right=None, timeout_ms=None,
) -> StringList

option_list_dates_async(...) awaits the same call shape.

Example

rows = tdx.option_list_dates("trade", "SPY", "20250321", strike="570", right="C")
for value in rows:
    print(value)

optionListDates(
  requestType: string, symbol: string, expiration: string | Date,
  options?: { ... },
): Promise<Array<string>>

Optional parameters ride in a single trailing options object: strike?: string, right?: string, timeoutMs?: number.

Example

const rows = await tdx.optionListDates('trade', 'SPY', '20250321', { strike: '570', right: 'C' });
for (const value of rows) {
  console.log(value);
}

std::vector<std::string> option_list_dates(
    const std::string& request_type,
    const std::string& symbol,
    const std::string& expiration,
    const EndpointRequestOptions& options = {}) const;

Optional parameters chain on EndpointRequestOptions: .with_strike(...), .with_right(...). Throws tdx::Error on failure.

Example

auto rows = client.option_list_dates("trade", "SPY", "20250321",
    tdx::EndpointRequestOptions{}.with_strike("570").with_right("C"));
for (const auto& value : rows) {
    std::cout << value << "\n";
}

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

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

Example

curl -G 'http://127.0.0.1:25503/v3/option/list/dates' \
    --data-urlencode 'request_type=trade' \
    --data-urlencode 'symbol=SPY' \
    --data-urlencode 'expiration=2025-03-21' \
    --data-urlencode 'strike=570' \
    --data-urlencode 'right=C'

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)
expiration	date	yes	—	Expiration date YYYYMMDD
strike	string	no	*	Strike price in dollars as a string (e.g. 500 or 17.5). Use * for wildcard selection.
right	string	no	both	Option side. Accepted values: call, put, both.
timeout_ms	int	no	—	Per-request deadline in milliseconds. 0 means no deadline.

Response

A list of strings — one date value per row.