Get Option Contracts

GET {{baseUrl}}/v2/options/contracts

This endpoint allows you to retrieve a list of option contracts based on various filtering criteria. By default only active contracts that expire before the upcoming weekend are returned.

Request Params

Key	Datatype	Description
`underlying_symbols`	string	Filter contracts by one or more underlying symbols.
`status`	string	Filter contracts by status (active/inactive). By default only active contracts are returned.
`expiration_date`	string	Filter contracts by the exact expiration date (format: YYYY-MM-DD).
`expiration_date_gte`	string	Filter contracts with expiration date greater than or equal to the specified date.
`expiration_date_lte`	string	Filter contracts with expiration date less than or equal to the specified date. By default this is set to the next weekend.
`root_symbol`	string	Filter contracts by the root symbol.
`type`	string	Filter contracts by the type (call/put).
`style`	string	Filter contracts by the style (american/european).
`strike_price_gte`	number	Filter contracts with strike price greater than or equal to the specified value.
`strike_price_lte`	number	Filter contracts with strike price less than or equal to the specified value.
`page_token`	string	Used for pagination, this token retrieves the next page of results. It is obtained from the response of the preceding page when additional pages are available.
`limit`	number	The number of contracts to limit per page (default=100, max=10000).

HEADERS

Key	Datatype	Required	Description
`Accept`	string
`Apca-Api-Key-Id`	string
`Apca-Api-Secret-Key`	string

RESPONSES

status: OK

{&quot;option_contracts&quot;:[{&quot;id&quot;:&quot;98359ef7-5124-49f3-85ea-5cf02df6defa&quot;,&quot;symbol&quot;:&quot;AAPL250620C00100000&quot;,&quot;name&quot;:&quot;AAPL Jun 20 2025 100 Call&quot;,&quot;status&quot;:&quot;active&quot;,&quot;tradable&quot;:true,&quot;expiration_date&quot;:&quot;2025-06-20&quot;,&quot;underlying_symbol&quot;:&quot;AAPL&quot;,&quot;underlying_asset_id&quot;:&quot;b0b6dd9d-8b9b-48a9-ba46-b9d54906e415&quot;,&quot;type&quot;:&quot;call&quot;,&quot;style&quot;:&quot;american&quot;,&quot;strike_price&quot;:&quot;100&quot;,&quot;size&quot;:&quot;100&quot;,&quot;root_symbol&quot;:&quot;AAPL&quot;,&quot;open_interest&quot;:&quot;237&quot;,&quot;open_interest_date&quot;:&quot;2023-12-11&quot;,&quot;close_price&quot;:&quot;148.38&quot;,&quot;close_price_date&quot;:&quot;2023-12-11&quot;},{&quot;id&quot;:&quot;98359ef7-5124-49f3-85ea-5cf02df6defa&quot;,&quot;symbol&quot;:&quot;AAPL250620C00100000&quot;,&quot;name&quot;:&quot;AAPL Jun 20 2025 100 Call&quot;,&quot;status&quot;:&quot;active&quot;,&quot;tradable&quot;:true,&quot;expiration_date&quot;:&quot;2025-06-20&quot;,&quot;underlying_symbol&quot;:&quot;AAPL&quot;,&quot;underlying_asset_id&quot;:&quot;b0b6dd9d-8b9b-48a9-ba46-b9d54906e415&quot;,&quot;type&quot;:&quot;call&quot;,&quot;style&quot;:&quot;american&quot;,&quot;strike_price&quot;:&quot;100&quot;,&quot;size&quot;:&quot;100&quot;,&quot;root_symbol&quot;:&quot;AAPL&quot;,&quot;open_interest&quot;:&quot;237&quot;,&quot;open_interest_date&quot;:&quot;2023-12-11&quot;,&quot;close_price&quot;:&quot;148.38&quot;,&quot;close_price_date&quot;:&quot;2023-12-11&quot;}],&quot;next_page_token&quot;:&quot;MTAwMA==&quot;}