ThetaData

Appearance

List Contracts ​

FreeValueStandardPro

REQUIRED

The Theta Terminal must be running to access data.

Lists all contracts that were traded or quoted on a particular date.
If the root parameter is specified, the returned contracts will be filtered to match the root.
Multiple roots can be specified by separating them with commas such as root=AAPL,SPY,AMD

Sample data contains partial output of the request as the full response to the request is too large to display on this webpage.

Throttle

A mandatory 500 millisecond overhead is applied to this request to limit bandwidth consumption. This type of request should increase your overall throughput as you will know exactly what is available for each trading day. If the 500 millisecond overhead is an issue, please contact support and they can remove it depending on the circumstances.

Sample URL

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

List all traded contracts

http://127.0.0.1:25510/v2/list/contracts/option/trade?start_date=20230512

List all quoted contracts

http://127.0.0.1:25510/v2/list/contracts/option/quote?start_date=20230512

List all quoted contracts with root filter

http://127.0.0.1:25510/v2/list/contracts/option/quote?start_date=20230512&root=AAPL,SPY

List all open interest contracts

http://127.0.0.1:25510/v2/list/contracts/option/open_interest?start_date=20230512

Parameters ​

Path Parameters

reqRequired  -

List all contracts that were traded or quoted.

Type: string (Default: trade)
Enumtrade, quote, open_interest

Query Parameters

start_dateRequired  -

The date to list all contracts for. Formatted as YYYYMMDD.

Type: string (Default: 20230512)
rootRequired  -

The symbol of the security. Option underlyings for indices might have special tickers.

Type: string (Default: SPX)

Sample Code