How to set up crypto liquidation alerts (and funding and whale alerts)
Set up crypto liquidation alerts step by step: alerts for liquidation clusters, big liquidations, funding and whales, channels like Telegram, and limits.
On this page
A liquidation alert tells you when something changes in the liquidation data without you watching a chart: the price moves close to a large cluster of liquidation levels, it enters a band of them, or a single large liquidation happens. On Blockmetric each alert is a rule with three parts, always in the same order: what to watch, the threshold, and the channels it is sent to.
This guide walks through the alert types around liquidations, funding and whales, how to set the thresholds so they fire at a useful rate, which channels exist and what alerts cannot do. Following one specific wallet is covered in its own guide: how to track a Hyperliquid wallet.
Step 1: pick what to watch
The form on Alerts groups the alert types by topic. The ones around liquidations are:
- Near a liquidation cluster. Fires when the mark price moves within a chosen percentage of a cluster of liquidation levels of at least a chosen size. The levels come from real Hyperliquid positions, the same data as the liquidation heatmap; a heatmap can also open the form prefilled with its coin.
- Price enters a liquidation band. Fires when the price moves into a price bucket of the liquidation map that holds at least a chosen amount of long or short liquidations.
- Big liquidation. Fires on a single liquidation above a size, on Hyperliquid or on an exchange, optionally for one coin or one venue.
- Near a whale stop cluster. Fires when the price moves within a chosen distance of a cluster of stop orders placed by the largest tracked whales.
Next to them, the same form offers:
- Funding. "Funding above / below" fires when annualised funding, the current rate or the predicted next one, crosses your threshold for one coin or any coin. "Funding extreme" follows the radar events for funding far from normal.
- Open interest and long/short. Open interest rising or falling by a chosen share within a window, and the long share of a coin moving by a number of percentage points.
- Whales. A tracked wallet opening, adding to, flipping or closing a position above a size; on Pro also a wallet near the top of the trader leaderboard opening a position.
- Price and order book. A price level crossed, a price move within a window, a large order book wall appearing near the price or being pulled.
On Desk, a combined alert joins two or three conditions on one coin, for example the price near a liquidation cluster and funding above a level at the same time.
Step 2: set the threshold
Every threshold is a trade-off between hearing about a change early and hearing about it too often. A few properties of the data help to place it:
- Distance and volatility move together. A distance that the price covers in minutes on a volatile coin can take days on a calm one. The realised volatility column of the markets screener shows how much each coin has been moving.
- Cluster size is relative. A cluster that is large for a small coin is ordinary for BTC. Looking at the coin's heatmap first shows what size its clusters usually have, and a minimum size above that keeps the alert to the clusters that stand out.
- Windows matter for moves. Price, open interest and long/short alerts measure a change within a window of five minutes up to 24 hours. The same percentage means much more in five minutes than in a day.
The options under each rule control repetition: "every time", "once, then pause" or "every time, until a date", a minimum number of minutes between two alerts, and an hourly digest that bundles minor alerts into one message while major and critical ones still come right away.
None of these thresholds is a level to trade. An alert says that a condition in the data became true, not what the price does next.
Step 3: choose the channels
The same channel picker appears on every alert form:
- E-mail. On every plan.
- Telegram. Link your Telegram account once, and alerts arrive in your private chat with the bot. The Telegram page explains the bot and its commands.
- Telegram groups and channels. Alerts posted into a group or channel you administer, connected with a one-time code. Part of Pro, Desk and the API plans.
- Alert webhooks. A signed JSON request to your own endpoint, for a bot or an internal tool. Part of Pro, Desk and the API plans. An endpoint that keeps failing is switched off and you get an e-mail.
Delivery settings apply to all rules at once: mute for a while, quiet hours in your own time zone (minor alerts are held and sent in the next digest), and the hourly digest. The number of rules, webhooks and groups per plan is listed in the comparison on Pricing.
Liquidation Guard for your own positions
For a position you hold yourself, Liquidation Guard is the more direct tool. You enter the address of your Hyperliquid wallet, read-only and without keys, and a distance between half a percent and twenty-five percent. Guard alerts you when one of the wallet's positions comes within that distance of its own liquidation price, and also when a position is opened, closed, flipped or liquidated. The liquidation price is where the account equity would fall below the maintenance margin, measured on the mark price.1
Guard re-arms quietly once the position has moved back a quarter beyond your threshold, so a price that hovers right at the line does not send one alert after another. On Telegram, each guarded position gets one message that is updated in place with the current distance. The liquidation guard glossary entry has the short definition, and the liquidation price formula explains where the liquidation price itself comes from.
How fast alerts arrive
Alerts follow the data they watch, and each kind of data is refreshed on its own schedule:
- Price, funding, open interest and long/short alerts are checked every 15 seconds against our market data.
- Near a liquidation cluster is checked every minute against the current liquidation map, which is itself rebuilt every few minutes from the tracked positions.
- Guard reads the guarded address about every 45 seconds; whale and wallet alerts follow our position polls, which reach the largest wallets about every two and a half minutes.
- Big liquidations arrive as the exchanges publish them on their streams and as Hyperliquid liquidations are confirmed by fills.
A failed delivery is retried several times with growing pauses. Every alert that fired is listed in the alert log under Alerts, with the time and the channel.
What alerts cannot do
- Trade for you. Alerts and Guard only read data. Nothing connects to your wallet or places orders.
- Arrive in milliseconds. Between the moment something changes and the message, there is the data refresh, the check and the delivery. For fast moves that can be the whole move.
- See every position. Liquidation levels come from tracked Hyperliquid positions. Exchanges do not publish positions, so their liquidation levels are not in the map, and exchange liquidation feeds report what the exchanges publish.
- Predict. A price near a cluster does not mean the cluster will be reached. Whether clusters attract price is a separate question, covered in do liquidation clusters attract price?
Common questions
Do alerts cost anything? Alerts, e-mail and Telegram delivery and Guard for one address are part of the Free plan. More rules, more watched addresses, groups, webhooks, watchlist alerts and combined alerts come with the paid plans.
Which coins can a liquidation alert watch? Big liquidation alerts work for any coin. Which coins the alerts on the liquidation map cover on each plan is listed in the comparison on Pricing.
Is there a Discord channel? No. Alerts go to e-mail, Telegram, Telegram groups and channels, and webhooks.
Sources
- Hyperliquid Docs, "Liquidations" (accessed 2026-11-11)Back to text
How we collect and check the data: Data & methodology.
See today’s numbersThe live pages update continuously.
Create an alert