Skip to content

Contracts (v3)

ValueStandardPro

REQUIRED

The v3 Theta Terminal must be running to access data.

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.

Sample URL

Paste the URL below into your browser while the Theta Terminal is running.

List all contracts for an option trade with a given date
http://localhost:25503/v3/option/list/contracts/trade?date=20220930

List all contracts for an option quote with a given symbol and date
http://localhost:25503/v3/option/list/contracts/quote?symbol=AAPL&date=20220930

Path Parameters

request_typeRequired  -

The request type.

Type: string
Enumtrade, quote

Query Parameters

symbol  -

The stock or index symbol, or underlying symbol for options.

Type: array
dateRequired  -

The date to fetch data for.

Type: string
format  -

The format of the data when returned to the user.

Type: string (Default: csv)
Enumcsv, json, ndjson

Sample Code

py