HL Book

API

The same numbers as the site, as JSON. Free, 60 requests a minute per key, cached ten seconds. Cite the source when you publish them.

Get a key

Sign this exact message with any wallet (the date is today in UTC; newlines are real newlines), then post it. The same wallet always gets the same key.

HL Book API key
0xYOURADDRESS
2026-09-21
curl -X POST https://hlbook.xyz/api/v1/keys \
  -H 'Content-Type: application/json' \
  -d '{"addr":"0x…","message":"HL Book API key\n0x…\n2026-09-21","signature":"0x…"}'
→ {"key":"hlb_…","rpm":60}

Endpoints

GETReturns
/api/v1/market/BTCMark, tracked long/short, exchange open interest and funding, liquidation map buckets, top 50 holders with entry and liquidation
/api/v1/trader/0x…Label, equity, net, gross, positions, fee-complete realized PnL where archived, equity curve, last 50 changes
/api/v1/liquidationsThe latest cross-market map: notional within 2/5/10/20% per coin and side
/api/v1/cascade/BTCEvery position with a liquidation price, compact, for your own cascade math
curl https://hlbook.xyz/api/v1/market/BTC -H 'x-api-key: hlb_…'

Embed the ladder

The live liquidation ladder for any market, as a widget for your site or newsletter. No key needed. It links back to the market page.

<iframe src="https://hlbook.xyz/embed/ladder/BTC" width="640" height="400" style="border:0;background:#141311" loading="lazy" title="BTC liquidation ladder by HL Book"></iframe>

Swap BTC for any listed coin. The replay of the last 24 hours is a plain image at /api/replay/BTC/gif?hours=24.

Semantics