expirations

Returns all valid option expiration dates for a given ticker supported by the real-time WebSocket feed.

GET/v2/options/{TICKER}/expiriesQuant Tier

Returns all valid option expiration dates for a given ticker supported by the real-time WebSocket feed.

Expiry Horizon & Usage

Subscription Required: Requires a Quant subscription or higher.
Published Horizon: Current Eastern calendar date through current date + 90 calendar days.
WebSocket Group Suffixes: Convert returned YYYY-MM-DD dates to YYYYMMDD format (e.g. 2026-07-17 becomes 20260717) for explicit-expiry WebSocket groups.
Supported Symbols: Query canonical option-owning tickers (SPX, NDX, SPY, QQQ), Quant stock tickers, or the Quant-only XSP index.

Request

Example: /v2/options/SPX/expiries

Headers

Name	Type	Description
`Authorization`	`string`	Required. Format: "Bearer <YOUR_API_KEY>"
`User-Agent`	`string`	Required. Identify your client application.
`Accept`	`string`	Required. Set to "application/json".

Path parameters

Name	Type	Description
`TICKER`	`string`	Supports standard and Quant-only stock/index tickers (e.g. `SPX`, `NDX`, `SPY`, `QQQ`, `XSP`).

Response

Field	Type	Description
`ticker`	`string`	Canonical ticker used for the expiry lookup.
`start_date`	`string`	Start of the published expiry horizon in `YYYY-MM-DD` format.
`end_date`	`string`	End of the published expiry horizon in `YYYY-MM-DD` format.
`expiries`	`array`	All valid option expiration dates. Remove dashes (`YYYYMMDD`) to build explicit-expiry WebSocket group suffixes.

{
  "ticker": "SPX",
  "start_date": "2026-07-10",
  "end_date": "2026-10-08",
  "expiries": [
    "2026-07-10",
    "2026-07-13",
    "2026-07-15",
    "2026-07-17"
  ]
}

{
  "type": "object",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Canonical ticker used for the expiry lookup."
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Start of the published expiry horizon in YYYY-MM-DD format."
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "End of the published expiry horizon in YYYY-MM-DD format."
    },
    "expiries": {
      "type": "array",
      "items": {
        "type": "string",
        "format": "date"
      },
      "description": "All valid option expiration dates in YYYY-MM-DD format within the published horizon."
    }
  }
}

type: object
properties:
  ticker:
    type: string
    description: Canonical ticker used for the expiry lookup.
  start_date:
    type: string
    format: date
    description: Start of the published expiry horizon in YYYY-MM-DD format.
  end_date:
    type: string
    format: date
    description: End of the published expiry horizon in YYYY-MM-DD format.
  expiries:
    type: array
    items:
      type: string
      format: date
    description: All valid option expiration dates in YYYY-MM-DD format within the published horizon.

expirations

Request

Headers

Path parameters

Response

On this page