---
title: "Option-contract directory for one required expiration, paged up to 200 contracts. ET dates use YYYY-MM-DD."
method: GET
path: "/v1/flow/tickers/{ticker}/contract-options"
---

# Option-contract directory for one required expiration, paged up to 200 contracts. ET dates use YYYY-MM-DD.

`GET /v1/flow/tickers/{ticker}/contract-options`

## Path parameters

- `ticker` string, required

## Query parameters

- `session_date` string, date
- `root` string
- `expiration` string, date, required
- `limit` integer
- `cursor` string

## Response `200`

list payload with next_cursor

## Other responses

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

## Changes

- **2026-09-23** `5f6ba5c8e653` — 2 info
  - for the `query` request parameter `expiration`, the type was generalized from no type to `string`, and format from no format to `date`
  - for the `query` request parameter `session_date`, the type was generalized from no type to `string`, and format from no format to `date`
- **2026-09-20** `bf1aa24fe417` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/changes/v1/flow/tickers/:ticker/contract-options/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/5f6ba5c8e653?raw)