DocsAPI ReferenceDirectional TradingHeatmap

Heatmap

The strike x expiration exposure matrix behind the dashboard heatmap, ready to render in your own UI.

Get the heatmap

GET/gex/heatmap

Computed live from the options chain across multiple expirations, so it is the most expensive endpoint in the API - it has a tight rate limit (10/min). For historical heatmaps use /gex/history?groupBy=expiration.

Parameters

symbolstringrequired

Ticker.

expirationsstring

Comma-separated YYYY-MM-DD dates (max 10). Defaults to the nearest 8 expirations.

formulastring

nominal, per_1pct or per_1dollar.

curl -H "Authorization: Bearer qw_live_YOUR_KEY" \
  "https://quantwheel.com/api/v1/gex/heatmap?symbol=QQQ"

Response

200 OK

{
  "ticker": "QQQ",
  "stockPrice": 554.10,
  "expirations": ["2026-07-31", "2026-08-01", "2026-08-07", "..."],
  "heatmapData": {
    "2026-07-31": {
      "netGamma": -210000000,
      "callWall": 560,
      "putWall": 550,
      "inflectionPoint": 553.2,
      "strikes": [
        { "strike": 550, "callGEX": 30000000, "putGEX": -120000000, "netGEX": -90000000 }
        // ... per strike
      ]
    }
    // ... per expiration
  },
  "aggregated": {
    "callWall": 560,
    "putWall": 550,
    "inflectionPoint": 553.6,
    "gammaZone": "negative"
  }
}

Rendering tips

Render heatmapData[expiration].strikes as columns with a diverging color scale centered at zero - positive cells pin price, negative cells accelerate it. The aggregated block gives you the combined walls and flip for the header row.

GEX, Vanna & Charm

Flow