---
title: "Historical chain NBBO series for one ticker + expiration + right (on-demand materialization)"
method: GET
path: "/v1/options/chain-history/{ticker}"
---

# Historical chain NBBO series for one ticker + expiration + right (on-demand materialization)

`GET /v1/options/chain-history/{ticker}`

## Path parameters

- `ticker` string, required

## Query parameters

- `expiration` union, required
  - string, date
  - string, date-time
- `right` 'C' | 'P', required
- `from` union, required
  - string, date
  - string, date-time
- `to` union, required
  - string, date
  - string, date-time
- `interval` '1m' | '5m' | '10m' | '15m' | '30m' | '1h', required

## Response `200`

object payload

## Other responses

- `400` — validation error
- `401` — authentication error
- `402` — subscription paused
- `403` — scope insufficient
- `429` — rate limited or quota exhausted

---

[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-service-production.skmtc.workers.dev/v1/apis/yehangshe/gex-heatmap-data-api/revisions/0068cd24c191/schema)