Skip to content

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.

Type: string
Enumoption, stock, index
reqRequired  -

The request type.

Type: string
Enumtrade, quote

Query Parameters

rootRequired  -

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

Type: string
exp  -

(Required for options) The expiration date of the option contract formatted as YYYYMMDD.

Type: integer
strike  -

(For options only) The strike price in 1/10th of a cent. A $140.00 strike price would be 140000.

Type: integer
right  -

(For options only) The right of the option. 'C' for call; 'P' for put.

Type: string
EnumC, P
use_csv  -

Output is in comma-separated values if true, legacy JSON if false.

Type: boolean (Default: false)

Responses

OK

Sample Code

py