> ## Documentation Index > Fetch the complete documentation index at: https://docs.gammaflip.io/llms.txt > Use this file to discover all available pages before exploring further. # List expirations > Returns sorted, non-expired option expirations for a given exchange and coin. `expirations` keeps the `DDMMMYY` codes; `expirations_detail` adds the ISO date, days to the cutoff, the cutoff instant and a 0DTE flag. The cutoff is 08:00 UTC for crypto and 16:00 US Eastern for TradFi. **Free**: not counted against the quota. ## OpenAPI ````yaml /openapi.yaml get /expirations/{exchange}/{coin} openapi: 3.1.0 info: title: GammaFlip GEX API version: 1.0.0 description: > Programmatic access to Gamma Exposure (GEX) data for crypto options (Bybit, Deribit, OKX, Derive) and US options (the `tradfi` exchange). API access is a plan entitlement (`api_access`). The trial includes it (50 requests/day); other plans with API access get 500 requests/day. Only `/gex/...`, `/levels/...` and the `/history/...` query endpoints count against the quota; `/exchanges`, `/coins`, `/expirations/...`, `/me` and `/history/coverage` are free. History file downloads use a separate daily bucket of file credits (trial 20, other plans 200). A `429` carries no `Retry-After` header: use `X-RateLimit-Reset`, `X-History-Files-Reset` or `/me`. All GEX values are USD per 1% move of the underlying. Field definitions: https://docs.gammaflip.io/data-dictionary contact: name: GammaFlip Support email: admin@gammaflip.io url: https://gammaflip.io servers: - url: https://api.gammaflip.io/api/v1 description: Production security: - ApiKeyAuth: [] paths: /expirations/{exchange}/{coin}: get: tags: - Discovery summary: List expirations description: > Returns sorted, non-expired option expirations for a given exchange and coin. `expirations` keeps the `DDMMMYY` codes; `expirations_detail` adds the ISO date, days to the cutoff, the cutoff instant and a 0DTE flag. The cutoff is 08:00 UTC for crypto and 16:00 US Eastern for TradFi. **Free**: not counted against the quota. operationId: listExpirations parameters: - $ref: '#/components/parameters/Exchange' - $ref: '#/components/parameters/Coin' responses: '200': description: Expiration list content: application/json: schema: allOf: - $ref: '#/components/schemas/Envelope' - type: object properties: data: type: object properties: expirations: type: array items: type: string example: - 25APR26 - 02MAY26 - 09MAY26 - 27JUN26 expirations_detail: type: array items: $ref: '#/components/schemas/ExpirationDetail' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '503': description: TradFi data temporarily unavailable (`market_unavailable`) content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: Exchange: name: exchange in: path required: true description: > Crypto: `bybit`, `deribit`, `okx`, `derive`, `all` / `combined`, or a `+`-joined subset such as `deribit+derive`. TradFi tickers: `tradfi` (`all` and `combined` are aliases). Use `/exchanges` for the live list. schema: type: string examples: - all - deribit+derive - tradfi Coin: name: coin in: path required: true description: >- Symbol (case-insensitive), for example `BTC` or `QQQ`. Use `/coins` for the list. schema: type: string example: BTC schemas: Envelope: type: object required: - data - meta properties: data: type: object description: The response payload. meta: type: object properties: timestamp: type: string format: date-time description: When the response was generated. example: '2026-04-14T10:00:00+00:00' exchange: type: string example: all coin: type: string example: BTC rate_limit: $ref: '#/components/schemas/RateLimit' ExpirationDetail: type: object properties: code: type: string example: 17OCT26 iso: type: - string - 'null' example: '2026-10-17' dte: type: - number - 'null' description: Days to the cutoff (two decimals). example: 11.2 cutoff_utc: type: - string - 'null' format: date-time example: '2026-10-17T20:00:00Z' is_0dte: type: boolean Error: type: object description: > Standard error body. `error` is a stable slug safe to branch on; `message` is human-readable prose that may change and must not be parsed. Errors are never wrapped in the data/meta envelope used by successful responses. Some errors add hint fields. required: - error - message properties: error: type: string enum: - unauthorized - subscription_required - market_not_in_plan - rate_limit_exceeded - invalid_exchange - invalid_pair - invalid_expiration - invalid_param - no_data - unsupported_coin - market_unavailable - history_not_available - range_too_large - no_snapshot - no_file - files_unavailable - history_files_limit_exceeded - method_not_allowed example: invalid_exchange message: type: string example: Exchange 'kraken' is not available. current_tier: type: string description: With `subscription_required` and `market_not_in_plan`. example: trial valid_exchanges: type: array items: type: string description: With `invalid_exchange`, `invalid_pair` and `history_not_available`. example: - deribit - bybit - okx - derive - combined nearest_expirations: type: array items: type: string description: >- With `invalid_expiration`; up to five ISO dates closest to the request (the earliest five if the value is not a date). example: - '2026-10-17' - '2026-10-19' valid_values: type: array items: type: string description: >- With `invalid_param` for `view`, `granularity`, `file` and `compare`. example: - full - levels max_value: type: number description: With `invalid_param` for `range_pct`. example: 50 max_window_days: type: integer description: With `range_too_large`. example: 31 nearest_timestamps: type: array items: type: string format: date-time description: With `no_snapshot`; up to three capture times closest to `at`. example: - '2026-10-05T20:15:00Z' - '2026-10-05T13:45:00Z' market: type: string description: With `market_not_in_plan`; the market the requested coin belongs to. enum: - crypto - tradfi example: tradfi markets_in_plan: type: array items: type: string description: With `market_not_in_plan`. supported_crypto: type: array items: type: string description: >- With `unsupported_coin`; crypto coins listed by at least one exchange. example: - BTC - ETH - HYPE - SOL - XRP supported_tradfi: type: array items: type: string description: With `unsupported_coin`; US tickers we track. example: - QQQ - SPX - SPY rate_limit: allOf: - $ref: '#/components/schemas/RateLimit' description: >- With `rate_limit_exceeded` and `history_files_limit_exceeded`; mirrors the X-RateLimit-* headers. RateLimit: type: object properties: limit: type: integer example: 500 remaining: type: integer example: 487 reset: type: string format: date-time example: '2026-04-15T00:00:00+00:00' responses: BadRequest: description: > `invalid_exchange`, `invalid_pair`, `invalid_expiration` or `invalid_param`, with hint fields (`valid_exchanges`, `nearest_expirations`, `valid_values`, `max_value`). content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: > Missing or invalid credential, or a credential that does not resolve to a user. Both return `unauthorized`. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: > `subscription_required` (the plan has no API access) or `market_not_in_plan` (the plan does not include the coin's market). content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: | API key prefixed with `gex_sk_`. Create one in your [account dashboard](https://gammaflip.io/account). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.