HyperCore · Price-level maps

Liquidation price map

Liquidation prices of every open position, from Hyperliquid's formula on each account's state, bucketed like the stop map.

GET https://api.femtos.xyz/v1/hypercore/liquidation-map

Parameters

curl -H "Authorization: Bearer $FEMTOS_KEY" "https://api.femtos.xyz/v1/hypercore/liquidation-map?coin=BTC&buckets=40&range_pct=10"

Key: Authorization: Bearer $FEMTOS_KEY. Get a free key, or with no browser through agent onboarding.

Field	Type	Meaning
`buckets[]`	object	Ascending price; empty when the mark is unknown: {pxLo, pxHi, long, short}
`below`	object	long: liquidated by a forced sell as price falls to it; short: by a forced buy as price rises to it: {long, short}
`above`	object	long: liquidated by a forced sell as price falls to it; short: by a forced buy as price rises to it: {long, short}
`totals`	object	long: liquidated by a forced sell as price falls to it; short: by a forced buy as price rises to it: {long, short}
`coverage`	object	How much of the open interest the map holds: every account's positions at the snapshot, each liquidation price from Hyperliquid's formula on the account state; none for portfolio-margin cross accounts and positions that cannot be liquidated: {positions, withLiqPx, sz, szWithLiqPx, share, note}
`asOf`	ms	Time of `height` (the positions snapshot)
`height`	int	Head block of the layer the answer is cut at: every event up to it is counted (the positions snapshot)
`markPx`	decimal \| null	Mark: last trade
`rangePct`	decimal	range_pct applied
`step`	decimal \| null	Bucket width

Forced flow GET /v1/hypercore/forced-flow
Stop-loss / take-profit orders and liquidations on the same buckets: the cascade (stops + liquidations, with the move) and the take-profits (against it) at each price.
Stop map stream WS hc.stops.map
The GET /api/hypercore/stops map, pushed whole on subscribe and every 5 s when it changes.
Liquidation map stream WS hc.liquidations.map
The GET /api/hypercore/liquidation-map map, pushed whole on subscribe and every 5 s when it changes.
Forced flow stream WS hc.forced_flow.map
The GET /api/hypercore/forced-flow map, pushed whole on subscribe and every 5 s when it changes.