---
title: "Dealer Heatmap expiration Top-node 5-minute history (three NYSE sessions, newest first)"
method: GET
path: "/v1/derived/heatmap/{ticker}/history"
---

# Dealer Heatmap expiration Top-node 5-minute history (three NYSE sessions, newest first)

`GET /v1/derived/heatmap/{ticker}/history`

## Path parameters

- `ticker` string, required

## Query parameters

- `expiration` string, date, required
- `from` union
  - string, date
  - string, date-time
- `to` union
  - string, date
  - string, date-time
- `limit` integer
- `cursor` string

## Response `200`

list payload with next_cursor

- object
  - `data` object[], required
    - `minute_at` string, date-time, required
    - `expiration` string, date, required
    - `spot_usd` number, nullable, required
    - `cells` object[], required — At most ten strongest positive and ten strongest negative net GEX nodes.
      - `strike_usd` number, required
      - `net_dealer_gex_usd` number, required
  - `_meta` ResponseMetaList, required
    - `request_id` string, nullable, required
    - `cache_hit` boolean, required
    - `data_freshness_seconds` integer, nullable, required
    - `truncated` unknown, required
    - `notice` string
    - `rate_limit_remaining` integer
    - `quota_remaining_pct` number
    - `data_source` 'internal'
    - `next_cursor` string, nullable, required

## 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` — 1 info
  - for the `query` request parameter `expiration`, the type was generalized from no type to `string`, and format from no format to `date`

[Change history](https://skmtc.dev/yehangshe/apis/gex-heatmap-data-api/changes/v1/derived/heatmap/:ticker/history/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)