Free crypto indicator Liquidation Heatmap for TradingView
The Liquidation Heatmap estimates where leveraged crypto positions would be liquidated. It reads open interest from Binance, Bybit, OKX and Bitget, places each new position's liquidation price across a mix of leverage, and draws the result as a full heatmap behind your candles.
On TradingView
What it draws on a real chart
Both captures come from the published indicator with its default Viridis palette. The map sits behind the candles, so price stays readable on top of it.
- Bands
- Rows of estimated liquidation levels, from dark purple (little) through teal to yellow (the most).
- Where a band ends
- Price traded through it, and the positions there count as liquidated.
- The profile past the last candle
- The levels open now, longer where more liquidity sits.
- Labels
- The largest clusters above and below price, with their price and dollars.
- The legend
- What each colour means in dollars per row.
The model
How the liquidation model works
Exchanges do not publish traders' liquidation prices, so the heatmap estimates them from what is public: open interest and price.
Read new open interest
Every bar, the indicator reads the change in open interest of the coin's USDT perpetual futures, from all four exchanges by default, and converts it to dollars. A rise means new positions opened.
Split it into longs and shorts
By default, open interest added on a green candle counts as longs and on a red candle as shorts. Close Location weighs the split by where the candle closed in its range; Balanced splits it evenly.
Place a level for each leverage
The new positions are spread over up to five entry prices across the candle and divided across the leverage mix. Each leverage places a level at its liquidation distance: the margin minus a 0.5% maintenance margin. Longs liquidate below entry, shorts above.
Remove the levels price reaches
A candle that trades through a level liquidates it, so the band ends there. Open levels also lose half their size every 200 bars, and can shrink when open interest falls.
Draw the map
Rows are about a third of an ATR tall by default. PineCanvas packs same-colour cells into shared drawings, so one map can hold up to 400,000 cells where the earlier version was limited to TradingView's 500 boxes.
Liquidation distance by leverage
| Leverage | Distance from entry |
|---|---|
| 3x | 32.8% |
| 5x | 19.5% |
| 10x | 9.5% |
| 25x | 3.5% |
| 50x | 1.5% |
| 100x | 0.5% |
Leverage mixes
| Mix | Leverage and share of new positions |
|---|---|
| Conservativedefault | 3x 15%, 5x 25%, 10x 35%, 20x 15%, 25x 10% |
| Retail5x to 100x | 5x 10%, 10x 25%, 25x 30%, 50x 20%, 100x 15% |
| Aggressive20x to 125x | 20x 15%, 25x 25%, 50x 30%, 100x 20%, 125x 10% |
| Customup to 8 tiers | Your own list, for example 10x 40%, 25x 40%, 100x 20% |
Sweeps
Liquidation sweeps, bubbles and alerts
When a candle trades through open levels, the indicator adds up the long and short liquidations it swept. A sweep at least three times the size of a typical one can mark the candle with a bubble and fire an alert.
- Long liquidations sit below the candle, short liquidations above it, and bubbles grow at two and four times the threshold.
- The Long liquidation sweep and Short liquidation sweep alerts use the same threshold, and an alert on any alert() function call sends the dollars swept once the candle closes.
- The amounts swept on each bar are also in the data window, as Long Liquidations Swept and Short Liquidations Swept.
For how sweeps of resting liquidity play out on a chart, read what liquidity engineering is.
Getting started
Set it up in TradingView
Open a crypto chart
Any coin with USDT perpetual futures on Binance, Bybit, OKX or Bitget, on a spot or a perpetual chart, for example BTCUSD or BTCUSDT.P.
Add the indicator
Open Indicators at the top of the chart, search for Crypto Liquidation Heatmap and pick the one by Alien_Algorithms. It is free, and no account with us is needed.
Choose the leverage mix
Conservative, the default, suits most charts. Retail and Aggressive assume higher leverage, which places levels closer to price.
Read the map beside your own analysis
Two common readings: price moving toward a bright band may continue until that liquidity is taken, and after a large sweep price may revert. Neither is a signal on its own.
Reference
Every setting, in plain words
The defaults draw the map in the captures above. Open a group to see what each setting changes.
Data
Where open interest comes from
- Open Interest
- All Exchanges (default) adds Binance, Bybit, OKX and Bitget. Auto uses the chart's own perpetual when it has open interest data, otherwise Binance. Each exchange can also be chosen on its own. Every source is converted to dollars.
- Custom Symbol
- Any TradingView open interest symbol, for example BINANCE:ETHUSDT.P_OI.
Liquidation Model
How positions become levels
- Leverage Mix
- Conservative (default), Retail, Aggressive or Custom. Each leverage tier places its own liquidation level for every new position.
- Long / Short Split
- Candle Direction (default) gives all new open interest to the candle's colour. Close Location gives more to longs when a candle closes near its high, more to shorts near its low. Balanced splits every position half and half.
- When OI Falls
- Keep Levels (default) ignores falls. Close All Evenly shrinks every level by the share of open interest that closed. Close Newest First keeps new positions provisional for 20 bars and cancels them first when open interest falls.
- Level Half-Life
- Every open level loses half its size over this many bars, 200 by default, so old levels far from price fade. 0 turns it off.
Heatmap
Width and resolution
- Width
- How many recent bars the map covers, 800 by default and up to 2,000. Up to 500 bars, every bar gets its own column.
- Row Height
- Automatic: half an ATR(100), rounded and multiplied by a factor, 0.6 by default. Or a fixed height in price.
- Max Cells
- The most rows times columns the map may use, 200,000 by default and up to 400,000. Typical charts use 60,000 to 140,000.
Style
Palettes and contrast
- Palette
- Viridis (default), Magma, Inferno, Plasma, Cividis (colour-vision friendly) or three custom colours.
- Long / Short Colors
- Paints long liquidation levels below price and short liquidation levels above price in two colours of your choice.
- Smoothing
- Blurs each band over up to three neighbouring rows. It changes the look only; sweeps, labels and alerts use the exact levels.
- Contrast
- At 1, colour follows size directly. Lower values bring mid-sized levels into view; higher values leave only the largest clusters bright. 1.5 by default.
- Opacity, Background Tint, Legend
- The opacity of the brightest cells, a tint of the darkest palette colour behind the map, and the legend's corner.
Live Levels
The profile and labels
- Live Profile
- Open levels extend past the last bar by a length set by their size, so the right edge reads as a histogram of where liquidity sits now.
- Cluster Labels
- Labels the largest open clusters above and below price with their price and the liquidity in that row, two per side by default.
Liquidation Bubbles
Sweeps and alerts
- Show Bubbles
- Marks a candle when the liquidations it swept are at least the threshold times a typical sweep, 3x by default. Bubbles grow at 2x and 4x the threshold.
- Alerts
- The Long liquidation sweep and Short liquidation sweep alerts use the same threshold. An alert on any alert() function call sends one message per closed candle with the dollars swept on each side.
Questions
Questions about the Liquidation Heatmap
Is the Liquidation Heatmap free?
Yes. It is published on TradingView as a free indicator, and anyone can add it to a chart. Its source code is protected, so it cannot be copied or edited.
Does it show real liquidations?
No. Exchanges do not publish traders' positions or liquidation prices, so no indicator can show them. The heatmap estimates where recently opened positions would be liquidated, from changes in open interest and an assumed mix of leverage. Treat the bands as estimates of where forced orders may cluster.
Which charts does it work on?
Crypto coins with USDT perpetual futures on Binance, Bybit, OKX or Bitget. By default it reads the coin's open interest from all four exchanges, so it works on a spot chart such as BTCUSD as well as on the perpetual itself. A custom open interest symbol covers other markets.
How does it work out the liquidation prices?
New open interest is split between longs and shorts, spread over up to five entry prices across the candle, and divided across a leverage mix. Each leverage places a level at its liquidation distance: the margin minus a 0.5% maintenance margin, so about 9.5% from entry at 10x, 3.5% at 25x and 0.5% at 100x. The default mix is Conservative, from 3x to 25x.
How does it tell longs from shorts?
By default from the candle's direction: open interest added on a green candle counts as longs, on a red candle as shorts. Close Location weighs the split by where the candle closed in its range, and Balanced splits every position evenly. All three are estimates.
Why do bands end?
When a candle trades through a level, the positions there count as liquidated and the level is removed, so the band stops at that candle. Open levels also fade: each loses half its size every 200 bars by default. Optional modes shrink levels when open interest falls.
Does it repaint?
Closed bars do not change. The current bar updates live as price and open interest move, and settles when it closes. In the Close Newest First mode, positions from the last 20 bars stay provisional and can still be cancelled by a fall in open interest.
Can it send alerts?
Yes. The Long liquidation sweep and Short liquidation sweep alerts fire when a candle sweeps liquidations at least 3 times the size of a typical sweep, and an alert on any alert() function call sends the dollars swept once the candle closes. The same threshold drives the optional bubbles on the chart.
Add the heatmap to your chart
It is free on TradingView. For order blocks, fair value gaps and liquidity read from the same chart, see the Institutional Imbalance Framework.
Drawn with PineCanvas, our open-source graphics engine for Pine Script.