What a Crypto Liquidation Is — and Why Tracking It Matters
A crypto liquidation is what happens when a leveraged position runs out of margin. The exchange force-closes the position at market, regardless of price or slippage. Those forced market orders hit the book alongside everyone else's orders, which is why big liquidation waves cause the chart to spike violently in one direction.
The liquidation data API at /api/v1/market-intelligence/liquidations aggregates forced-close volume across every major perp venue and gives you three things you can't infer from price alone: where the pain is (which symbol, long or short), how much got liquidated, and when the cascade started. Read together, they tell you whether you're watching a bottom being made or just the first domino.
Liquidation Cascades: How Forced Selling Compounds
A single liquidation isn't scary. A cascade is. The dynamics are mechanical and repeat every cycle:
- Step 1. Price moves 2-3% against a crowded side. First tranche of liqs hits — usually the smallest, highest-leverage retail positions.
- Step 2. Forced market orders eat through the thin book. Price moves another 2-3%.
- Step 3. The next tier of positions (slightly lower leverage) hits their maintenance margin. They liquidate. More market orders.
- Step 4. Panic manual closing from accounts still above maintenance. Now it's a proper cascade.
The cascade usually stops when both of these happen: leveraged OI has been meaningfully flushed, and a large buyer (or short-coverer) steps in aggressively. Watching liquidation volume drop off while price stabilises is the classic capitulation bottom signature. Watching it keep rising while price falls is the classic falling-knife.
How Do Trading Bots React to Liquidation Data?
Liquidation data is a near-real-time risk gauge. Three agent patterns that work:
- Capitulation buyer — when 1h long-liquidation volume exceeds its 30-day 95th percentile and price has rolled over by >5% intraday, the agent scales in a long with a tight stop below the wick.
- Volatility expansion alert — sudden liquidation spikes are the best leading indicator of realised volatility regime shifts. Agents can pull back position sizing the moment 24h liq volume exits normal range.
- Squeeze confirmation — if an agent is holding a contrarian short-against-crowded-longs position, a liquidation spike is the trade working. Time to tighten stops and lock in gains.
Liquidations vs Open Interest: What's the Relationship?
OI tells you how much leverage is in the market. Liquidations tell you how much is being forced out. They're linked but measure different stages of the cycle.
| Scenario | OI | Liquidations | Interpretation |
|---|---|---|---|
| Build-up | Rising fast | Low | Leverage loading — squeeze risk growing |
| Initial flush | Rolling over | Spiking | Cascade in progress |
| Reset | Down hard | Dropping from peak | Capitulation complete — fresh entries safer |
| Grinding | Flat | Near zero | Low-vol regime — wait for catalyst |
OI and liquidation data are always read together. Either one alone gives you half the picture.
Pulling Liquidation Data via API
The main endpoint aggregates across all exchanges and returns per-symbol totals:
curl "https://cryptodataapi.com/api/v1/market-intelligence/liquidations?limit=20" \
-H "X-API-Key: cdk_live_YOUR_KEY"For the per-exchange breakdown on a specific symbol:
curl "https://cryptodataapi.com/api/v1/market-intelligence/liquidations/by-exchange?symbol=BTC" \
-H "X-API-Key: cdk_live_YOUR_KEY"A cascade detector in Python:
import httpx
r = httpx.get(
"https://cryptodataapi.com/api/v1/market-intelligence/liquidations",
params={"limit": 50},
headers={"X-API-Key": "cdk_live_YOUR_KEY"},
)
rows = r.json()["data"]
# Top 5 symbols by 24h long-liquidation volume
longs = sorted(rows, key=lambda x: x.get("long_liquidation_usd_24h", 0), reverse=True)[:5]
for row in longs:
print(f"{row['symbol']:8s} long liqs 24h: ${row['long_liquidation_usd_24h']:,.0f}")Response fields include symbol, exchange, liquidation_usd_24h, long_liquidation_usd_24h, short_liquidation_usd_24h, and timestamps. For options-market liquidations (call writers getting forced out), see /api/v1/market-intelligence/options.
When Liquidations Mean a Bottom vs a Top
The same liquidation data can signal a bottom or a top depending on context.
- Long liquidations spiking in a downtrend — classic capitulation setup. The crowded-long trade is finally getting flushed. If OI drops with price and liquidations peak, that's a buyable local bottom more often than not.
- Long liquidations spiking at all-time highs — different beast. This is usually a failed breakout where late longs got euphoric, and the wash-out marks the start of distribution. Buying into this typically means buying into a range-top.
- Short liquidations spiking after a long downtrend — the first rally off a bear-market bottom. Shorts who've made money for months get blown out and fuel the rip. Great continuation setup.
- Short liquidations spiking in uptrend — late-stage bull euphoria. Shorts who tried to fade a grinding uptrend give up. Often marks a local top, not a continuation.
For the positioning side of the same story, see long/short ratio as a contrarian indicator. For the pricing side, see cross-exchange funding rates.
