---
title: "Option contracts with quote or trade data on one US Eastern date for one ticker, across all expirations. data_type defaults to quote. SPX includes SPX and SPXW roots, preserved in each OCC contract_symbol. Rows include expiration, strike_usd and right. Complete directory paginated by OCC symbol, 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/contracts-on-date/{ticker}"
---

# Option contracts with quote or trade data on one US Eastern date for one ticker, across all expirations. data_type defaults to quote. SPX includes SPX and SPXW roots, preserved in each OCC contract_symbol. Rows include expiration, strike_usd and right. Complete directory paginated by OCC symbol, 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/contracts-on-date/{ticker}`

## Request

- Base URL: `https://api.yehangshe.com`
- URL: `https://api.yehangshe.com/v1/options/contracts-on-date/{ticker}`
- Auth: HTTP bearer

## Path parameters

- `ticker` string, required

## Query parameters

- `date` string, date, required
- `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/contracts-on-date/:ticker/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)
