latestOpenAPI 3.0.32026-08-101461131.1 MB

ad6f143e43aa

reference:options:contracts:list

Options Contracts

Query for historical options contracts. This provides both active and expired options contracts.

get/v3/reference/options/contracts

Query parameters

underlying_tickerstring

Query for contracts relating to an underlying stock ticker.

tickerstring

This parameter has been deprecated. To search by specific options ticker, use the Options Contract endpoint here.

contract_type'call' | 'put'

Query by the type of contract.

expiration_datestring

Query by contract expiration with date format YYYY-MM-DD.

as_ofstring

Specify a point in time for contracts as of this date with format YYYY-MM-DD. Defaults to today's date.

strike_pricenumber

Query by strike price of a contract.

expiredboolean

Query for expired contracts. Default is false.

underlying_ticker.gtestring

Range by underlying_ticker.

underlying_ticker.gtstring

Range by underlying_ticker.

underlying_ticker.ltestring

Range by underlying_ticker.

underlying_ticker.ltstring

Range by underlying_ticker.

expiration_date.gtestring

Range by expiration_date.

expiration_date.gtstring

Range by expiration_date.

expiration_date.ltestring

Range by expiration_date.

expiration_date.ltstring

Range by expiration_date.

strike_price.gtenumber

Range by strike_price.

strike_price.gtnumber

Range by strike_price.

strike_price.ltenumber

Range by strike_price.

strike_price.ltnumber

Range by strike_price.

order'asc' | 'desc'
Example:asc

Order results based on the sort field.

limitinteger
Example:10

Limit the number of results returned, default is 10 and max is 1000.

sort'ticker' | 'underlying_ticker' | 'expiration_date' | 'strike_price'
Example:ticker

Sort field used for ordering.

Response

A list of options contracts

next_urlstring

If present, this value can be used to fetch the next page of data.

request_idstring

A request id assigned by the server.

statusstring

The status of this request's response.