( api docs )
zanshinflow.com/api/v1 · GET · json or plain lines
Fourendpoints,// onekey
Everything the API answers, with a real example of each. Keys come from the dashboard; what it's for is on the API page.
The reference
One symbol per request: sym is one of SPX, SPY, NDX, QQQ, IWM, ES, NQ, RTY, GC or CL. The futures books are live overnight; an index or ETF book also comes back in its future's prices, moved with the live basis.
GET/levels?sym=SPX
The levels the charts draw
The gamma flip and regime, the three call walls and three put walls with the dealer gamma at each, the king strike and max pain. An index or ETF book carries the same levels on its future under fut (SPX and SPY on ES, NDX and QQQ on NQ, IWM on RTY).
symone of the ten books · requiredformatlines · plain text, one NAME,price per line, for a platform that reads a file or a URLpricesfut · with format=lines: the future's prices instead of the strikesWalls are the three biggest gross-gamma strikes on each side of spot within one day's expected move, at least two strike gaps apart: the same pick as the app. stale is true when the book is older than three minutes.
GET /levels?sym=SPX200{ "sym": "SPX", "as_of": 1794150000, "session": "RTH", "stale": false, "spot": 7376.86, "regime": "SHORT_GAMMA", // LONG_GAMMA, SHORT_GAMMA, AT_FLIP "flip": 7400, "king": 7410, "max_pain": 7390, "call_walls": [7430, 7450, 7475], // at or above price, biggest first "put_walls": [7375, 7360, 7340], "king_gex": 2410000000, // net dealer gamma, $ per 1% move "call_wall_gex": [1620000000, 910000000, 440000000], "put_wall_gex": [-1870000000, -940000000, -510000000], "net_gex": -1200000000, "fut": { // the same levels on ES "sym": "ES", "spot": 7402.25, "flip": 7425.5, "king": 7435.5, "max_pain": 7415.5, "call_walls": [7455.5, 7475.5, 7500.5], "put_walls": [7400.5, 7385.5, 7365.5], "king_gex": 2410000000, "call_wall_gex": […], "put_wall_gex": […] } }
GET/levels?sym=SPX&format=lines&prices=fut
Nothing to parse
The same levels as plain text, one per line, in the future's prices. A Sierra Chart, NinjaTrader or MotiveWave study that reads a line per level, a spreadsheet's web query or a shell script takes these as they are.
GET /levels?sym=SPX&format=lines&prices=futtext/plainSYM,ES
AS_OF,1794150000
STALE,0
REGIME,SHORT_GAMMA
SPOT,7402.25
KING,7435.5
FLIP,7425.5
MP,7415.5
CW1,7455.5
CW2,7475.5
CW3,7500.5
PW1,7400.5
PW2,7385.5
PW3,7365.5
GET/gex?sym=SPX&range=0.02
Dealer gamma by strike
For a tool that draws its own map: at each strike near price the net and gross dealer gamma, the same-day (0DTE) gross gamma, delta exposure, vanna and charm, plus the book's totals and its gamma by expiry.
symone of the ten books · requiredrange0.002 to 0.1 · strikes within this fraction of spot; default 0.02 (±2%)GET /gex?sym=SPX&range=0.02200{ "sym": "SPX", "as_of": 1794150000, "session": "RTH", "stale": false, "spot": 7376.86, "fut": { "sym": "ES", "spot": 7402.25 }, "gamma_sign": -1, "flip": 7400, "net_gex": -1200000000, "gross_0dte_share": 0.41, // how much of today's gross gamma expires today "gex_by_dte": { "0": -800000000, "1": -150000000, "2": 50000000, "7+": -300000000 }, "range": 0.02, "strikes": [ // sorted by strike, each with its price on the future { "strike": 7375, "fut": 7400.4, "net_gex": -1870000000, "gross_gex": 2100000000, "gross_gex_0dte": 900000000, "dex": -41000000, "vanna": 12000000, "charm": -3000000 }, … ] }
GET/symbols and /me
The books, and the key
/symbols lists the ten books, what each is and which future its levels can be drawn on. /me checks a key: whether it works, the plan behind it, the key's name and the limits. Good for a tool's settings screen.
GET /symbols200{ "symbols": [ { "sym": "SPX", "kind": "index", "fut": "ES" }, { "sym": "ES", "kind": "future", "fut": null }, … ] }
GET /me200{ "ok": true, "plan": "active", "key": { "id": "3f9c2a1b7d0e", "name": "my bot", "made": 1794000000 }, "limits": { "per_minute": 120, "fresh_s": 10 }, "endpoints": ["levels", "gex", "symbols", "me", "days", "history", "series"] }
GET/history with /days and /series
Any session on record
The same books, back through every recorded session. /days lists the sessions and the datasets. /history?sym=SPX&day=2026-11-12 answers one book on one day as columns and rows: data=levels (the walls, KING, the flip, the regime and net gamma in 1-minute rows), flow (the hedging line, net premium and net delta), bars, prints, strikes (gamma strike by strike as the day ended) or daily (the session on one line). day=today is the session so far, and data=daily&day=all answers every session at once.
Cut it as you need it: hours=rth keeps 09:30 to 16:00 New York, every=5, 15 or 60 thins the rows, time=ny or utc writes times as text, format=csv answers a CSV file. /series?sym=SPX is the book's net gamma and price at 15-minute steps across every session, in one answer.
GET /history?sym=SPX&day=2026-11-12&hours=rth&every=5&time=ny200{ "sym": "SPX", "day": "2026-11-12", "data": "levels", "hours": "rth", "every_min": 5, "columns": ["sym", "time_ny", "spot", "call_wall", "put_wall", "king", "gamma_flip", "gamma_sign", "vwap", "max_pain", "atm_iv", "net_gex_usd_per_1pct", … ], "rows": [ // arrays, in column order ["SPX", "2026-11-12 09:34:00", 7575.82, 7600, 7550, 7565, 7601.25, -1, null, 7605, 0.2627, -6480087962, … ], ["SPX", "2026-11-12 09:39:00", 7595.48, 7600, 7565, 7565, 7602.8, -1, null, 7605, 0.2603, -1740100208, … ], … ] }
Python every session of a book, one line eachimport requests, pandas as pd b = requests.get( "https://www.zanshinflow.com/api/v1/history", headers={"Authorization": "Bearer YOUR_KEY"}, params={"sym": "SPX", "data": "daily", "day": "all"}, ).json() df = pd.DataFrame(b["rows"], columns=b["columns"]) # day, open, high, low, close, range_pct, net_gex_open_musd, # gamma_sign_open, king_open, call_wall_open, put_wall_open, …
Four lines
The key in the header, the symbol in the query. Everything else is your tool's.
Pythonimport os, requests r = requests.get("https://www.zanshinflow.com/api/v1/levels", params={"sym": "ES"}, timeout=10, headers={"Authorization": f"Bearer {os.environ['ZANSHIN_KEY']}"}) L = r.json() print(L["regime"], L["flip"], L["call_walls"], L["put_walls"])
JavaScriptconst r = await fetch( "https://www.zanshinflow.com/api/v1/gex?sym=SPX&range=0.01", { headers: { Authorization: `Bearer ${process.env.ZANSHIN_KEY}` } }); const G = await r.json(); const biggest = G.strikes .sort((a, b) => Math.abs(b.net_gex) - Math.abs(a.net_gex))[0];
curlcurl -H "Authorization: Bearer $ZANSHIN_KEY" \ "https://www.zanshinflow.com/api/v1/levels?sym=NQ"
A platform that reads a file# the lines every 15 s; point the study at levels.txt while true; do curl -s -H "Authorization: Bearer $ZANSHIN_KEY" \ "https://www.zanshinflow.com/api/v1/levels?sym=SPX&format=lines&prices=fut" \ > levels.txt; sleep 15 done
Fresh, bounded
The engine publishes about every 30 seconds and the API caches each symbol for 10, so polling faster returns the same answer. Requests are counted per key on the dashboard, by day and endpoint.
30s
between books from the engine; as_of says when this one was computed.
10s
the API's cache per symbol. A tool polling every symbol every 10 s stays well inside the limit.
120/ min
requests per key. Over it, 429 with a Retry-After.
bad_symsym isn't one of the ten booksno_keyno Authorization headerbad_keynot a Zanshin keyrevokedsigned out on the dashboard, or replaced by a fourth keyno_subscriptionthe trial or subscription has endedpayment_overduethe last payment failedno_addonthe account has no API add-on (the trial is over and it wasn't added)rate_limitedover 120 a minute on this key; wait and retryno book for that symbol yet, or a moment of downtime; retryWhat people build
Levels on another chart platform
Sierra Chart, NinjaTrader, MotiveWave or a web chart reading the lines output on a timer. TradingView has the extension.
A bot's context
Before a trade: where is price against the flip and the nearest wall, and how big is the wall. One levels call.
Your own gamma map
gex at ±5%, drawn your way: a heatmap, a ladder, net against gross, 0DTE against the rest.
A log for research
The levels into a CSV through the session, to test later how price behaved at them. Zanshin's own tests are at call wall and put wall.
( the way in )
3 market days free · then $15 a month · api and extension + $10
Keys are made on the API dashboard; the add-on is on for the whole trial.
Not financial advice. The levels are Zanshin Flow's estimates of dealer positioning; nothing here is a recommendation to buy or sell anything. Use of the API is under the terms; the data is for your own tools, not for redistribution.