- Live API Reference
- Flow Analytics
- 0DTE Flow
- 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
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.
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.
{
"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_price | number | Current underlying spot |
expiration | string | Today's 0DTE expiry (ET) |
metric | string | Echoes the requested metric |
mode | string | Echoes the requested mode (raw / delta) |
bar_size | string | Echoes the requested bar size |
as_of | string | Server time the response was built (UTC) |
tier_used | string | Storage tier the data was read from |
strikes_grid | array | Strikes for the matrix; values[i] maps to strikes_grid[i] |
bars[].t | string | Bar timestamp (UTC) |
bars[].spot | number | Underlying spot at the bar |
bars[].values | array | Per-strike metric values, parallel by index to strikes_grid |
gap_intervals | array | Reserved for sampler-gap intervals; not yet populated |
symbol | string | Underlying symbol |
market_open | boolean | true during US market hours |
bars | array | Bars |
endpoint_version, data_as_of | string, object | Response envelope, see Response envelope. |
Errors
| Status | Error | When |
|---|---|---|
400 | bar_unavailable | bar is anything other than 1m. |
400 | invalid_metric | metric not in gex|dex|vex|chex|oi|signed_flow. |
400 | invalid_mode | mode is not raw/delta. |
400 | no_strike_data_for_window | Rows 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. |
403 | tier_restricted | Your plan is below Alpha. The body includes current_plan and required_plan. |
429 | Quota exceeded | Daily 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_gridand the per-barvaluesarray, the column-major shape charting libraries expect - Switch the projected layer with
metricacrossgex,dex,vex,chex,oi, andsigned_flowto read whichever exposure drives your setup - Use
mode=deltato 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_gridasspotmoves, anticipating the next support or resistance - Watch the row nearest
underlying_pricefor the ATM strike most likely to act as the closing pin magnet - Spot a sign flip in a strike's
valuesover time as the bar where that level switches from supportive to repellent dealer positioning
Related
Related reading
- Live 0DTE pin-risk API: the intraday flow-adjusted magnet - reading the heatmap's ATM concentration as a pin signal
- 0DTE SPY: the complete intraday playbook - trading the strike-by-time grid through the session
Complementary endpoints
- 0DTE Strike Flow - the single-strike time series behind one heatmap row
- 0DTE Flow Series - the aggregate headline metrics across the same session
- Flow Levels - the named walls and magnet the heatmap visualizes
Unlock DEX, VEX and CHEX with Basic
Everything in Free, plus:
- DEX, VEX and CHEX exposure
- Full max pain
- ETF & index symbols SPY, QQQ, SPX, VIX
Go full-chain with Growth
Everything in Basic, plus:
- Full-chain GEX Every expiration
- 0DTE analytics
- Exposure summary & AI narrative
- CME futures & live screener
Add history and vol surfaces with Alpha
Everything in Growth, plus:
- Historical API replay Since 2017
- SVI vol surfaces
- VRP analytics
- Greeks surfaces Vanna, charm, volga and speed grids