ThetaData

Appearance

List Dates ​

FreeValueStandardPro

REQUIRED

The Theta Terminal must be running to access data.

Behavior

Lists all dates of data that are available for a given security type, request type, and contract. To list all dates of data available for an option chain, simply omit the strike and right parameters and only include the exp and root parameters. Make sure you're sec is option. There is data for at least one of the contracts on the chain for each day on the returned list. It does not mean that every option contract under that expiration will have data.
This endpoint is updated overnight.
Sample data contains partial output of the request as the full response to the request is too large to display on this webpage.

Sample URL

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

List all dates for a stock

http://127.0.0.1:25510/v2/list/dates/stock/quote?root=AAPL

List all dates for an index

http://127.0.0.1:25510/v2/list/dates/index/trade?root=SPX

List all dates for an option chain:

http://127.0.0.1:25510/v2/list/dates/option/quote?root=AAPL&exp=20220930

List all dates for an option:

http://127.0.0.1:25510/v2/list/dates/option/quote?root=AAPL&exp=20220930&strike=140000&right=C

Parameters ​

Path Parameters

secRequired  -

The security type. Either stock or option.

Type: string
Enumstock, option
reqRequired  -

The request type. This can be any historical request type outlined in this documentation.

Type: string
Enumquote, trade, implied_volatility

Query Parameters

rootRequired  -

The ticker / symbol of the security.

Type: string (Default: AAPL)
strike  -

The strike price in 1/10th of a cent. A $140.00 strike price would be 140000.

Type: integer
exp  -

The expiration date of the option contract formatted as YYYYMMDD.

Type: integer
right  -

The right of the option. 'C' for call; 'P' for put.

Type: string
EnumC, P

Responses ​

OK
JSON
{
"header": {
"id": 0,
"latency_ms": 0,
"error_type": "string",
"error_msg": "string",
"format": [
"date"
]
},
"response": [
20241101,
20241104
]
}

Sample Code

py