expirations

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

GET/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.
Caching: The server caches the list for 12 hours and returns Cache-Control: public, max-age=43200. Poll at most twice a day.

Request

Example: /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, distinct and in ascending order, inclusive of `start_date` and `end_date`. 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",
  "required": ["ticker", "start_date", "end_date", "expiries"],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "Canonical ticker used for the expiry lookup."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start of the published expiry horizon in YYYY-MM-DD format."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "End of the published expiry horizon in YYYY-MM-DD format."
    },
    "expiries": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
      },
      "description": "All valid option expiration dates in YYYY-MM-DD format within the published horizon."
    }
  }
}

type: object
required: [ticker, start_date, end_date, expiries]
properties:
  ticker:
    type: string
    description: Canonical ticker used for the expiry lookup.
  start_date:
    type: string
    pattern: "^\\d{4}-\\d{2}-\\d{2}$"
    description: Start of the published expiry horizon in YYYY-MM-DD format.
  end_date:
    type: string
    pattern: "^\\d{4}-\\d{2}-\\d{2}$"
    description: End of the published expiry horizon in YYYY-MM-DD format.
  expiries:
    type: array
    items:
      type: string
      pattern: "^\\d{4}-\\d{2}-\\d{2}$"
    description: All valid option expiration dates in YYYY-MM-DD format within the published horizon.

Errors

Status	When	Body
`400`	Invalid ticker format, unknown option ticker, synthetic futures ticker, a missing `User-Agent` or `Authorization` header.	`{"error": "<message>"}`
`401`	The API key is not valid.	(no body)
`403`	The key is not a gexbot API key, or the subscription is below Quant.	(no body)
`429`	The account exceeded its daily or monthly quota for this endpoint.	`{"error": "Rate limit exceeded."}`
`503`	Option reference data is not available. Retry later.	`{"error": "<message>"}`