Contracts

FreeValueStandardPro

List all option contracts traded or quoted on a given date, optionally filtered to a symbol.

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. When symbol is omitted the full universe of contracts for that date is returned. This endpoint is updated real-time.

trade · 20250303

Client

Auth

Style

request_typestring*

datedate*

symbolstring

max_dteint

from thetadatadx import Client

client = Client.from_env()

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

Sample response · JSON

[
  {
    "expiration": "2023-06-16",
    "right": "CALL",
    "strike": 260,
    "symbol": "ABNB"
  },
  {
    "expiration": "2023-06-16",
    "right": "CALL",
    "strike": 260,
    "symbol": "AAPL"
  },
  {
    "expiration": "2022-09-30",
    "right": "CALL",
    "strike": 14.5,
    "symbol": "AAL"
  }
]

Parameters

Name	Type	Required	Default	Description
request_type	string	yes	-	Request type. Accepted values: trade, quote, eod, ohlc.
date	date	yes	-	Date YYYYMMDD
symbol	string	no	-	Ticker symbol to filter by (e.g. AAPL), or a comma-separated list (AAPL,SPY) for the contracts of each. Omit to list every contract for the date.
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.