Guide

Liquidation map vs liquidation heatmap: what each one shows

A liquidation map is one snapshot of liquidation levels by price; a heatmap stacks those snapshots over time. How to read each, and how they are built.

Blockmetric ResearchUpdated 6 min read

On this page
  1. The short version
  2. What a liquidation map shows
  3. Reading the cumulative curves
  4. What a liquidation heatmap adds
  5. Two ways to build the levels
  6. When to use which
  7. Limits of the data
  8. Common questions

A liquidation map shows, for one moment, how much open position size would be liquidated at each price level. A liquidation heatmap stacks many of those moments side by side, so you can see how the levels formed, moved and faded over time. The map answers "what sits where right now"; the heatmap answers "how did it get there".

This guide explains what each chart shows, how to read the cumulative curves of a map, the two ways such charts are built, and when each view is the better tool.

The short version

Liquidation mapLiquidation heatmap
TimeOne snapshotMany snapshots, time from left to right
PriceVertical axis (or horizontal on some charts)Vertical axis
SizeBar length per price bucketBrightness of a cell
ExtraCumulative curves from the price outwardsHow long a band has existed, and whether it was reached
Best for"What would a move to this price liquidate now?""Is this level new, old, growing or fading?"

Both charts use the same raw ingredient: the liquidation price of each open leveraged position, added up per price bucket. On Hyperliquid a position is liquidated when the account equity falls below the maintenance margin, measured on the mark price.1 Long positions have their liquidation price below the current price, short positions above it.

What a liquidation map shows

A liquidation map is a profile. Each bar is one price bucket, and its length is the USD size of positions whose liquidation price sits in that bucket at the snapshot time. Long levels sit below the price and short levels above it, because a long is closed when the price falls and a short when it rises.

On Blockmetric the map is the column on the right side of every liquidation heatmap, drawn on the same price rows as the heatmap cells. It always shows the newest snapshot in view. Next to the bars run two lines: the cumulative long curve from the price downwards and the cumulative short curve from the price upwards.

Reading the cumulative curves

A single bar tells you what sits at one level. The cumulative curve tells you what a move from the current price to that level would pass through. It adds up every bucket between the price and the level you point at.

That makes the curve the better tool for questions about a whole move, and the bars better for spotting one dense level. Hovering a row on our chart shows both: the USD in that bucket and the cumulative USD a move to it would liquidate. Clicking a cell lists the tracked wallets whose liquidation price sits in that bucket now.

What a liquidation heatmap adds

A heatmap is the same profile repeated for every snapshot, turned on its side and coloured. Time runs from left to right, price from bottom to top, and a bright cell means a lot of size would be liquidated at that price at that time. Green cells are long levels, red cells short levels, each side on its own colour scale.

The time axis is what the map cannot show:

  • Age of a level. A band that has stayed bright for days is size that has been parked there for a long time. A band that appeared an hour ago is new positioning.
  • Fading. Traders add margin, cut size or close as the price approaches. On a heatmap that shows up as a band that dims before the price gets there.
  • Hits. When the price trades through a band and it disappears from one column to the next, the positions in it were closed, by liquidation or by their owners as the price arrived. Our liquidations page lists the liquidations that were confirmed.

The full walk-through of the heatmap, with an example, is in How to read a liquidation heatmap.

Two ways to build the levels

Charts called "liquidation map" or "liquidation heatmap" are not all built the same way. The difference matters more than the chart style.

From reported liquidation prices. On Hyperliquid every open position is public per address, and the info endpoint returns each position with its own liquidation price.2 A map can then add up real reported levels. This is how our maps and heatmaps are built: from the positions of the Hyperliquid and Lighter accounts we track and every open dYdX and GMX position read from the chain (for those two we compute the liquidation price from the on-chain state), rebuilt every few minutes, plus a daily snapshot of every open Hyperliquid position taken shortly after 00:00 UTC.

From estimates. Most centralised exchanges do not publish positions. A chart for those venues has to approximate: it takes changes in open interest and trading volume at each price and assumes a spread of leverage settings to place hypothetical liquidation prices. Such a chart shows where liquidations could sit if the assumptions hold. It cannot show where they actually sit, and two charts with different assumptions draw different maps from the same market.

When you compare charts, check which of the two you are looking at. A reported map is narrower in coverage (the venues whose positions can be read, tracked wallets) but each level is a real number. A modelled map covers more venues but each level is a model output. Both methods and their limits are compared in Modelled vs real liquidation heatmap.

When to use which

  • Use the map to size what lies between the current price and a level: "how much long size sits within the next few percent?" The cumulative curve answers it in one glance.
  • Use the heatmap to judge whether a level is stable: a band that survived several approaches is different from one that formed in the last hour.
  • Use both around a large cluster. The map says how big it is now; the heatmap says whether it is growing or being reduced as the price nears it.

Whether the price tends to reach large clusters at all is a separate question. Our scoreboard records each published cluster in advance and checks whether the price reached it within fixed windows, and Do liquidation clusters attract price? explains how to read that record. Neither chart is a forecast: both describe where forced orders would appear, not whether the price will get there.

Limits of the data

  • Tracked wallets. Intraday maps and heatmap columns cover the Hyperliquid wallets we poll, which includes the large ones far better than the small ones. The daily snapshot covers every position, once a day.
  • Minutes old. Each snapshot is a few minutes old by the time you see it, and positions can change in between.
  • Hyperliquid levels only. Exchange positions are not public, so exchange liquidation levels are not in our maps. Exchange liquidations that already happened appear on the liquidations page as the exchanges publish them.
  • Buckets. Size is grouped into price buckets, so a bar shows the total of a range, not one exact price.

The definition and method sit on the liquidation heatmap metric page, and the API serves the current map at /liqmap/{coin} and the history at /heatmap/{coin} (see the API reference).

Common questions

Is a liquidation map the same as a liquidation heatmap? No. A map is one snapshot by price; a heatmap is many snapshots over time. Many tools show both together, as we do.

Why do long levels sit below the price? A long position loses value when the price falls, so its liquidation price is below the entry. A short is the mirror image, so short levels sit above the price.

Why does a band fade before the price reaches it? The holders of those positions see the same risk. Adding margin moves the liquidation price away, and closing removes the level altogether.

Sources

  1. Hyperliquid Docs, "Liquidations" (accessed 2026-11-11)Back to text
  2. Hyperliquid Docs, "Info endpoint: Perpetuals" (accessed 2026-11-11)Back to text

How we collect and check the data: Data & methodology.

See today’s numbersThe live pages update continuously.

Open the BTC heatmap and map
LiveHyperliquid markets 13sOperationalHyperliquid positions & whales 11sOperationalLiquidation heatmap & levels 18sOperationalLighter markets & liquidations 30sOperationalLighter positions & heatmap 12sOperationalLighter RH positions & heatmap 16sOperationalBinance markets 1mOperationalBybit markets 20sOperationalBinance liquidations 28sOperationalBybit liquidations 28sOperationaldYdX positions & heatmap 24sOperationalGMX positions & heatmap 25sOperationalLong/short & open interest history 1mOperationalOrder books & trade flow 11sOperationalOn-chain transfers 20sOperationalSecurity monitor 12sOperationalBlockmetric Sentiment 1mOperationalAgency releases 6mOperationalAlert delivery 17sOperationalDataset files 7mOperational16:14:23 UTCData: Blockmetric Research