Liquidation heatmap (real positions)

A map of where leveraged positions would be force-closed. Each cell is the USD notional of tracked Hyperliquid positions whose own liquidation price lies in that price bucket at that moment. Longs liquidate below the current price, shorts above it.

In one sentence: Each cell = the USD of tracked positions that would be liquidated at that price, at that moment. Brighter = more.

Formula

cell(time, bucket) = Σ position USD of every tracked position whose liquidation price lies in the bucket
bucket size ≈ 0.5 % of the mark, range mark ± 50 % (top 20 coins at 1m: 0.1 % within ± 10 %)

• The collector polls the public Hyperliquid API (clearinghouseState) for the open positions of every tracked wallet and reads each position’s own liquidation price. No leverage is assumed.
• Liquidation prices are summed in USD per price bucket (about 0.5 % of the mark) within ±50 % of the mark; the current map of a coin is rebuilt at most once a minute when its positions change, and every 10 minutes in any case.
• Every 5 minutes the map of the top 60 coins by open interest (plus every coin with a tracked position of $1M or more) is stored as a snapshot, for the top 20 coins also every minute in 0.1% buckets within ±10%; the heatmap over time shows one column per interval (1m to 1D), showing the levels at its start, on a price grid around the current mark.
• The 1D view adds a daily history: for every day it covers, a snapshot of every open Hyperliquid position taken shortly after 00:00 UTC, in the same buckets; only the days it does not cover yet (normally today) come from the tracked wallets. Its price grid spans the whole range the price moved through.

• Bright bands are price levels where a lot of USD would be liquidated at once.
• A band that persists over many columns is a level where positions stayed open; a band that fades was closed or liquidated.
• It shows where forced orders would happen, not whether the price will get there.

• Reading a bright band as a price target. The map shows where positions would be closed by force; whether the price gets there is measured afterwards on the cluster scoreboard.
• Comparing a daily (1D) column with a live column. Daily columns count every open Hyperliquid position, live columns only the tracked wallets, so daily columns are brighter by design.
• Expecting exchange liquidations on the map. Binance and Bybit publish no positions, so their levels are not on it; their liquidations that happened are on the liquidations page.

• GET /api/v1/heatmap/{coin}
• GET /api/v1/liqmap/{coin}

Every key uses the data of its plan; see the developer docs for parameters and examples. Developers · API docs

• Free: every coin for the last 24 hours.
• Pro and above: every coin, history up to 1095 days (as far as collected).
• API: free developer key (10/min, 1,000/day, free-tier data, non-commercial) · API Dev and above (60/min, 50,000/day).

Pricing → · Historical data