---
title: "Available quote or trade dates for one exact OCC option contract, including expired contracts. Preserve the exact root such as SPXW for weekly options. data_type defaults to quote. dates rows contain a US Eastern calendar date and are paginated in ascending order. 1 unit per successful page. as_of and freshness are null because the source has no content timestamp. First request may return 202 during materialization."
method: GET
path: "/v1/options/available-dates/{contract}"
---

# Available quote or trade dates for one exact OCC option contract, including expired contracts. Preserve the exact root such as SPXW for weekly options. data_type defaults to quote. dates rows contain a US Eastern calendar date and are paginated in ascending order. 1 unit per successful page. as_of and freshness are null because the source has no content timestamp. First request may return 202 during materialization.

`GET /v1/options/available-dates/{contract}`

## Request

- Base URL: `https://api.yehangshe.com`
- URL: `https://api.yehangshe.com/v1/options/available-dates/{contract}`
- Auth: HTTP bearer

## Path parameters

- `contract` string, required

## Query parameters

- `data_type` 'quote' | 'trade'
- `limit` integer
- `cursor` string

## Response `200`

paginated object payload with next_cursor

## Other responses

- `400`: validation error
- `401`: authentication error
- `402`: subscription paused
- `403`: scope insufficient, dataset access not enabled, or plan tier required
- `429`: rate limited or quota exhausted

## Changes

- **2026-11-17** `7ee9c45cd645`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/changes/v1/options/available-dates/:contract/get.md)

---

[API](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api.md) - [All operations](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/revisions/7ee9c45cd645?raw)
