0DTE Heatmap API - Strike x Time 0DTE Value Matrix | FlashAlpha
  1. Heatmap

0DTE Heatmap API

A per-strike value matrix over today's 0DTE session - the data behind a strike-by-time heatmap. Strikes are pulled into a top-level strikes_grid and each bar carries a values array that is parallel by index to strikes_grid, the column-major shape heatmap charting libraries expect.

Endpoint

GET /v1/flow/zero-dte/heatmap/{symbol}
Auth required (X-Api-Key) Rate Limited: Yes Plan: Alpha+

Parameters

Name In Type Required Default Description
symbol path string required - Underlying symbol. Trimmed and upper-cased.
metric query enum gex Per-strike value to project. One of gex, dex, vex, chex, oi, signed_flow. Invalid returns 400 invalid_metric.
mode query enum raw raw (absolute per-bar value) or delta (bar-over-bar change; bar 0 stays raw). For signed_flow, delta is equivalent to raw. Invalid returns 400 invalid_mode.
bar query enum 1m Bar size. Only 1m is supported in this phase (5m/15m are planned); any other value returns 400 bar_unavailable.
minutes query integer 60 Lookback window in minutes. Clamped to 1-390. Non-numeric values return a 400 problem-details body.

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/zero-dte/heatmap/SPY?metric=gex&mode=raw&bar=1m&minutes=120"
import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/zero-dte/heatmap/SPY",
    params={"metric": "gex", "mode": "raw", "bar": "1m", "minutes": 120},
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(data["strikes_grid"])
const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/zero-dte/heatmap/SPY?metric=gex&mode=raw&bar=1m&minutes=120",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(data.strikes_grid);

Try it live

Runs on live market data and uses 1 request from your daily quota.

GET

Response

{
  "symbol": "SPY",
  "underlying_price": 760.26,
  "expiration": "2026-10-30",
  "metric": "gex",
  "mode": "raw",
  "bar_size": "1m",
  "as_of": "2026-10-30T13:46:08.0563026Z",
  "market_open": true,
  "tier_used": "raw",
  "strikes_grid": [
    470,
    475,
    480
  ],
  "bars": [
    {
      "t": "2026-10-30T13:30:00",
      "spot": 761.32,
      "values": [
        3254.47,
        0,
        0
      ]
    },
    {
      "t": "2026-10-30T13:30:30",
      "spot": 761.09,
      "values": [
        869.6157,
        108.4629,
        90.3
      ]
    }
  ],
  "gap_intervals": [],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa4",
    "equity_feed": "2026-10-30T13:46:07.859Z",
    "equity_options_feed": "2026-10-30T13:46:07Z",
    "index_feed": "2026-10-30T13:46:07.09Z",
    "index_options_feed": "2026-10-30T13:46:03Z",
    "futures_feed": "2026-10-30T13:46:07.407Z",
    "futures_options_feed": "2026-10-30T13:45:49.971Z",
    "flow_feed": "2026-10-30T13:45:00Z",
    "oi_feed": "2026-10-29T20:00:00Z",
    "macro_feed": "2026-10-29T21:00:20Z"
  }
}

Sending request…

See this endpoint on live data

Send this exact request and the real response shows up here, right next to the example.

No 0DTE samples in the window returns 200 with empty strikes_grid and bars arrays - there is no no_zero_dte / session_closed envelope.

Response when the market is closed

Outside the session the endpoint still returns 200 with market_open: false and empty arrays. Captured 2026-10-30 07:27 UTC.

Response
{
  "symbol": "SPY",
  "expiration": "2026-10-30",
  "metric": "gex",
  "mode": "raw",
  "bar_size": "1m",
  "as_of": "2026-10-30T07:27:49.3407165Z",
  "market_open": false,
  "tier_used": "raw",
  "strikes_grid": [],
  "bars": [],
  "gap_intervals": [],
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa4",
    "equity_feed": "2026-10-30T04:00:00.155Z",
    "equity_options_feed": "2026-10-29T21:15:01Z",
    "index_feed": "2026-10-30T07:27:31.288Z",
    "index_options_feed": "2026-10-29T21:00:01Z",
    "futures_feed": "2026-10-30T07:27:39.149Z",
    "futures_options_feed": "2026-10-30T07:27:39.15Z",
    "flow_feed": "2026-10-30T03:44:00Z",
    "oi_feed": "2026-10-29T00:00:00Z",
    "macro_feed": "2026-10-29T20:00:00Z"
  }
}

Response Fields

Field Type Description
underlying_pricenumberCurrent underlying spot
expirationstringToday's 0DTE expiry (ET)
metricstringEchoes the requested metric
modestringEchoes the requested mode (raw / delta)
bar_sizestringEchoes the requested bar size
as_ofstringServer time the response was built (UTC)
tier_usedstringStorage tier the data was read from
strikes_gridarrayStrikes for the matrix; values[i] maps to strikes_grid[i]
bars[].tstringBar timestamp (UTC)
bars[].spotnumberUnderlying spot at the bar
bars[].valuesarrayPer-strike metric values, parallel by index to strikes_grid
gap_intervalsarrayReserved for sampler-gap intervals; not yet populated
symbolstringUnderlying symbol
market_openbooleantrue during US market hours
barsarrayBars
endpoint_version, data_as_ofstring, objectResponse envelope, see Response envelope.

Errors

Status Error When
400bar_unavailablebar is anything other than 1m.
400invalid_metricmetric not in gex|dex|vex|chex|oi|signed_flow.
400invalid_modemode is not raw/delta.
400no_strike_data_for_windowRows exist in the window but none carry per-strike data (legacy v1 rows)
400-A query value has the wrong type, or a required value is missing. The body is an RFC 7807 problem-details object with errors.<param>.
401-Missing or invalid X-Api-Key. The body is empty; check the status code before parsing JSON.
403tier_restrictedYour plan is below Alpha. The body includes current_plan and required_plan.
429Quota exceededDaily quota used up. Retry-After gives the seconds until the reset at 00:00 UTC. Rejected requests (including 403) count toward the quota.

About

The heatmap endpoint returns a per-strike value matrix over today's 0DTE session - the data behind a strike-by-time heatmap. Strikes are pulled into a top-level strikes_grid and each bar carries a values array that is parallel by index to strikes_grid (i.e. values[strike_idx]), the column-major shape every heatmap charting library expects.

Choose the projected metric with metric (GEX, DEX, VEX, CHEX, OI, or signed flow) and switch between absolute values and bar-over-bar change with mode.

Common Use Cases

  • Render a strike-by-time heatmap directly from strikes_grid and the per-bar values array, the column-major shape charting libraries expect
  • Switch the projected layer with metric across gex, dex, vex, chex, oi, and signed_flow to read whichever exposure drives your setup
  • Use mode=delta to highlight where exposure is building or unwinding minute over minute rather than its absolute level
  • Track how the brightest cells (walls and concentrations) migrate across strikes_grid as spot moves, anticipating the next support or resistance
  • Watch the row nearest underlying_price for the ATM strike most likely to act as the closing pin magnet
  • Spot a sign flip in a strike's values over time as the bar where that level switches from supportive to repellent dealer positioning

Related reading

Complementary endpoints

Ready to build with FlashAlpha?

Get your free API key and start pulling live options data in 60 seconds.

No credit card required Setup in 60 seconds Secure & reliable