Contracts (v3)

ValueStandardPro

GET

https://localhost:25503/v3/option/list/contracts/{request_type}

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

max_dte  -

If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned.

Type: int32

format  -

The format of the data when returned to the user.

Type: string (Default: csv)

Enumcsv, json, ndjson, html

Responses

List all contracts for an option trade with a given date

Content-Type

array of:

Sample Code

Python