---
title: "Strike × time greek heatmap"
method: GET
path: "/gex/time-heatmap"
tags: ["GEX"]
---

# Strike × time greek heatmap

`GET /gex/time-heatmap`

## Request

- Base URL: `https://docs.backquant.com/v2`
- URL: `https://docs.backquant.com/v2/gex/time-heatmap`
- Auth: API key in header `X-API-Key`

Time-series of greek exposures by strike. Pick the greek (`gex|dex|vex|charm|vanna`) and bound by DTE / OI / IV. Without filters this serves the pre-computed cache (cheap); with filters it reconstructs from raw snapshots (more work, but still bounded to the last ~48 ticks).

## Query parameters

- `symbol` 'BTCUSDT' | 'ETHUSDT' | 'SOLUSDT' | 'HYPEUSDT': Trading symbol: BTCUSDT, ETHUSDT, SOLUSDT, or HYPEUSDT.
- `greek` 'gex' | 'dex' | 'vex' | 'charm' | 'vanna': Greek to display.
- `dte_min` integer: Inclusive lower bound on days-to-expiry for contributing contracts.
- `dte_max` integer: Inclusive upper bound on days-to-expiry.
- `min_oi` number: Drop contracts with open interest below this value.
- `iv_min` number: Inclusive lower bound on IV (in % e.g. 50 for 50%).
- `iv_max` number: Inclusive upper bound on IV (in %).

## Headers

- `X-API-Key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Invalid or missing API key
- `404`: No data available for the requested resource
- `422`: Validation error on query parameters
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/backquant/apis/backquant-api-v2.md) · [All operations](https://skmtc.dev/backquant/apis/backquant-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/backquant/apis/backquant-api-v2/revisions/3c1c96b3cc24?raw)