All Contracts
GET
/v3/reference/options/contracts
Retrieve a comprehensive index of options contracts, encompassing both active and expired listings. This endpoint can return a broad selection of contracts or be narrowed down to those tied to a specific underlying ticker. Each contract entry includes details such as contract type (call/put), exercise style, expiration date, and strike price. By exploring this index, users can assess market availability, analyze contract characteristics, and refine their options trading or research strategies.
Use Cases: Market availability analysis, strategy development, research and modeling, contract exploration.
Query Parameters
underlying_ticker
string
Query for contracts relating to an underlying stock ticker.
ticker
string
This parameter has been deprecated. To search by specific options ticker, use the Options Contract endpoint here.
contract_type
enum (string)
Query by the type of contract.
expiration_date
string
Query by contract expiration with date format YYYY-MM-DD.
as_of
string
Specify a point in time for contracts as of this date with format YYYY-MM-DD. Defaults to today's date.
strike_price
number
Query by strike price of a contract.
expired
boolean
Query for expired contracts. Default is false.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 10 and max is 1000.
sort
enum (string)
Sort field used for ordering.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
optional
A request id assigned by the server.
results
array (object)
optional
An array of results containing the requested data.
additional_underlyings
array (object)
optional
If an option contract has additional underlyings or deliverables associated with it, they will appear here.
See here for some examples of what might cause a contract to have additional underlyings.
cfi
string
optional
The 6 letter CFI code of the contract (defined in ISO 10962)
contract_type
string
optional
The type of contract. Can be "put", "call", or in some rare cases, "other".
correction
integer
optional
The correction number for this option contract.
exercise_style
enum (american, european, bermudan)
optional
The exercise style of this contract. See this link for more details on exercise styles.
expiration_date
string
optional
The contract's expiration date in YYYY-MM-DD format.
primary_exchange
string
optional
The MIC code of the primary exchange that this contract is listed on.
shares_per_contract
number
optional
The number of shares per contract for this contract.
strike_price
number
optional
The strike price of the option contract.
ticker
string
optional
The ticker for the option contract.
underlying_ticker
string
optional
The underlying ticker that the option contract relates to.
status
string
optional
The status of this request's response.