Flow Levels API

Endpoint

Parameters

Request

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/flow/levels/SPY"

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/flow/levels/SPY",
    headers={"X-Api-Key": "YOUR_API_KEY"}
)
resp.raise_for_status()
data = resp.json()
print(f"Live gamma flip: {data['live_gamma_flip']}")
print(f"Live call wall: {data['live_call_wall']}")
print(f"Live put wall:  {data['live_put_wall']}")

const resp = await fetch(
  "https://lab.flashalpha.com/v1/flow/levels/SPY",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
const data = await resp.json();
console.log(`Live gamma flip: ${data.live_gamma_flip}`);
console.log(`Live call wall: ${data.live_call_wall}`);
console.log(`Live put wall:  ${data.live_put_wall}`);

{
  "symbol": "SPY",
  "as_of": "2026-10-30T13:45:45.6227323Z",
  "underlying_price": 760.35,
  "expiry": null,
  "live_gamma_flip": 770.0162,
  "gamma_flip_status": "available",
  "live_call_wall": 800,
  "live_put_wall": 760,
  "live_max_pain": 765,
  "endpoint_version": "2026.09.30",
  "data_as_of": {
    "node": "fa5",
    "equity_feed": "2026-10-30T13:45:45.819Z",
    "equity_options_feed": "2026-10-30T13:45:45Z",
    "index_feed": "2026-10-30T13:45:44.115Z",
    "index_options_feed": "2026-10-30T13:45:44Z",
    "futures_feed": "2026-10-30T13:45:45.387Z",
    "futures_options_feed": "2026-10-30T13:45:27.486Z",
    "flow_feed": "2026-10-30T13:45:00Z",
    "oi_feed": "2026-10-29T20:00:00Z",
    "macro_feed": "2026-10-29T21:00:20Z"
  }
}

Response Fields

Any field may be null if the underlying profile cannot resolve it (e.g., no gamma flip exists in the strike range).

Errors

About Flow Levels

Flow Levels returns the live versions of the four key technical levels traders anchor to: gamma flip, call wall, put wall, and max pain. The settled versions in /v1/exposure/levels are computed on the morning OPRA-broadcast OI and stay fixed all session. This endpoint runs the same level-detection logic on the OI simulator's effective OI, so when a wall starts losing OI or a new strike accumulates positioning, the levels move with it. Same definitions, intraday-adjusted inputs.

Common Use Cases

• Trade against live walls, not stale ones - read live_call_wall as intraday resistance and live_put_wall as support, and re-anchor entries/targets as they migrate off the morning levels
• Flip regime on live_gamma_flip - fade extensions and trade mean-reversion above it; respect momentum and trend below it, switching bias the moment spot crosses the live flip
• Alert when the flip crosses spot - diff live_gamma_flip against underlying_price and fire when the sign flips, catching the dampening-to-amplifying handoff in real time
• Set EOD targets on live_max_pain - treat the live max pain strike as the close-of-day magnet and plan exits toward it as expiry approaches
• Confirm setups before sizing up - validate a long against a nearby live_put_wall or a short against live_call_wall so you only press trades the dealer book supports
• Surface a "levels are shifting" signal - diff each live field against the settled /v1/exposure/levels values and flag the largest deltas as early evidence of intraday repositioning
• Handle null levels gracefully - any field can be null when the profile can't resolve it (e.g. no flip in range), so gate dependent logic instead of assuming a number

Related

Related reading

• Intraday gamma-flip tracker: live flow levels - build a session-long tracker on these exact fields
• Live GEX vs settled GEX explained - why effective-OI levels move while the morning ones stay frozen

Complementary endpoints

• Key Levels - the settled morning baseline to diff these live levels against
• Live Flow GEX - the per-strike profile these walls and the flip are derived from
• Flow Pin Risk - scores how strongly price is being pulled toward the live max-pain magnet
• Live Flow DEX - directional dealer positioning to pair with the gamma walls