v1

latestOpenAPI 3.0.02026-07-26166415635.8 KB

Assets

Get Option Contracts (BETA)

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.

get/v1/options/contracts

Query parameters

underlying_symbolsstring

Filter contracts by one or more underlying symbols.

show_deliverablesboolean

Include deliverables array in the response.

status'active' | 'inactive'

Filter contracts by status (active/inactive). By default only active contracts are returned.

expiration_datestring date

Filter contracts by the exact expiration date (format: YYYY-MM-DD). If no expiration date filters (expiration_date, expiration_date_gte, or expiration_date_lte) are provided, the endpoint defaults to returning contracts with expiration dates on or before the upcoming weekend.

expiration_date_gtestring date

Filter contracts with expiration date greater than or equal to the specified date.

expiration_date_ltestring date

Filter contracts with expiration date less than or equal to the specified date. By default this is set to the next weekend.

root_symbolstring

Filter contracts by the root symbol.

type'call' | 'put'

Filter contracts by the type (call/put).

style'american' | 'european'

Filter contracts by the style (american/european).

strike_price_gtenumber

Filter contracts with strike price greater than or equal to the specified value.

strike_price_ltenumber

Filter contracts with strike price less than or equal to the specified value.

page_tokenstring

Example:MA==

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.

limitinteger

The number of contracts to limit per page (default=100, max=10000).

ppindboolean

The ppind(Penny Program Indicator) field indicates whether an option contract is eligible for penny price increments, with true meaning it is part of the Penny Program and false meaning it is not.

Response

Successful Response.

next_page_tokenstring nullable

Use this token in your next API call to paginate through the dataset and retrieve the next page of results. A null token indicates there are no more data to fetch.

Example response

{
  "next_page_token": "MTAwMA==",
  "option_contracts": [
    {
      "close_price": "148.38",
      "close_price_date": "2023-12-11",
      "deliverables": [
        {
          "allocation_percentage": "100",
          "amount": "100",
          "asset_id": "b0b6dd9d-8b9b-48a9-ba46-b9d54906e415",
          "settlement_method": "CCC",
          "settlement_type": "T+2",
          "symbol": "AAPL",
          "type": "equity"
        }
      ],
      "expiration_date": "2025-06-20",
      "id": "98359ef7-5124-49f3-85ea-5cf02df6defa",
      "multiplier": "100",
      "name": "AAPL Jun 20 2025 100 Call",
      "open_interest": "237",
      "open_interest_date": "2023-12-11",
      "root_symbol": "AAPL",
      "size": "100",
      "status": "active",
      "strike_price": "100",
      "style": "american",
      "symbol": "AAPL250620C00100000",
      "tradable": true,
      "type": "call",
      "underlying_asset_id": "b0b6dd9d-8b9b-48a9-ba46-b9d54906e415",
      "underlying_symbol": "AAPL"
    }
  ]
}