CoinGlass Liquidation Heatmap Scraper

🔥 CoinGlass Liquidation Heatmap Scraper

Get CoinGlass liquidation data as clean JSON: the BTC liquidation heatmap grid (models 1, 2 and 3), the 100x / 50x / 25x liquidation level lines for any coin on any exchange, and the key liquidation clusters for 700+ coins. No CoinGlass account, no API key, results in seconds.

✨ Why use CoinGlass Liquidation Heatmap Scraper?

• ⚡ Fast — a heatmap or a levels chart comes back in a few seconds, all 700+ coins in one request.
• 🔓 No login or API key — uses the same public data the CoinGlass website shows to visitors.
• 🧮 Ready for analysis — price axis, liquidation leverage cells, OHLCV candles and the 10 strongest levels already picked out.
• 🌍 Any coin, any exchange — liquidation levels work for Binance, OKX, Bybit, Bitget, Hyperliquid and more.
• 💸 Cheap — pay per heatmap or chart, not per hour.
• 🔁 Easy to schedule — run it every few minutes and build your own liquidation history.

🎯 Use cases

• 📈 Trading dashboards — plot liquidation heatmaps next to your own charts.
• 🎯 Entry, exit and stop placement — see where large clusters of leveraged positions get liquidated.
• 🤖 Quant and bot signals — feed nearest long and short liquidation prices into your strategy.
• 🧾 Market research — compare liquidation clusters across 700+ coins in one table.
• 🗂️ History building — CoinGlass shows only the current view; scheduled runs keep every snapshot.

🚀 How to use

1. Pick What to scrape: liquidation heatmap, liquidation levels, or all coins.
2. Add coins (BTC, ETH) or exchange pairs (Binance:ETHUSDT, OKX:BTC-USDT-SWAP).
3. Choose the heatmap models and time range, or the levels time range.
4. Click Start and wait a few seconds.
5. Download the results as JSON, CSV or Excel, or read them through the API.

📥 Input

{
  "mode": "heatmap",
  "symbols": ["BTC"],
  "models": ["model1", "model2", "model3"],
  "interval": "24h",
  "maxItems": 20
}

📤 Output

Heatmap results:

Levels results add levels (side, leverage, price, size, start and end time, active), nearest_long_liquidation_price, nearest_short_liquidation_price and the largest active long and short levels. All-coins results have price, clusters_above, clusters_below, the largest cluster on each side and CoinGlass's long and short risk scores.

{
  "success": true,
  "message": "BTC liquidation heatmap (model1, 24h): 134 price levels x 288 candles.",
  "symbol": "BTC",
  "exchange": "All exchanges",
  "pair": null,
  "model": "model1",
  "interval": "24h",
  "current_price": 82794.7,
  "range_low": 72938.0,
  "range_high": 91981.6,
  "strongest_levels": [
    {"price": 80682.56, "liquidation_leverage": 86501880.95},
    {"price": 82079.12, "liquidation_leverage": 76890834.3}
  ],
  "price_levels_count": 134,
  "candles_count": 288,
  "cells_count": 13151,
  "updateTime": 1792565355077,
  "updated_at": "2026-10-21T06:49:15Z",
  "y_axis": [78143.36, 78206.84, 78270.32],
  "liquidation_leverage_data": [[5, 31, 7790285.02], [5, 82, 7790285.02]],
  "price_candlesticks": [[1792479000, "81805.1", "81817.9", "81742.5", "81770.5", "15419597.4422"]],
  "url": "https://www.coinglass.com/pro/futures/LiquidationHeatMap?coin=BTC&type=symbol",
  "scraped_at": "2026-10-21T06:49:24.567Z"
}

Arrays are shortened here; real results hold the full grid.

💰 Pricing

• $0.007 per heatmap or levels chart — 1,000 heatmaps ≈ $7.
• $0.50 per 1,000 coin rows in the all-coins mode — all 700+ coins ≈ $0.37.
• Platform usage (a few seconds of compute and a little datacenter proxy traffic) is billed on top: about $0.0002 for a one-heatmap run and under $0.001 for the runs in our tests.
• Example: one BTC heatmap ≈ $0.0072 in total; the three BTC models ≈ $0.0215.
• Combinations that need a CoinGlass login are reported in the run status and never charged.

❓ FAQ

Is it legal? The actor reads the same public pages any visitor sees, without logging in. Check that your use fits CoinGlass's terms and your local rules.

Do I need a CoinGlass account or proxy? No account. Datacenter proxies are used by default and are included in the platform usage.

Why only BTC heatmaps? CoinGlass shows liquidation heatmaps to visitors without an account for BTC only (all exchanges or Binance BTC/USDT, 24h for every model, 48h for model 3). Other coins and ranges need a CoinGlass login, which this actor does not use. For other coins, use the liquidation levels or all-coins mode: they are public for every coin.

How many results do I get? One result per coin and model in heatmap mode, one per coin or pair in levels mode, and one per coin (700+) in all-coins mode, up to maxItems.

What if a field is empty? pair is empty for heatmaps aggregated over all exchanges, and price_candlesticks is empty in levels mode when you turn candles off. Everything else comes straight from CoinGlass.

Can I schedule it or use the API? Yes. Schedule runs in the console, or start them over the API and read the dataset as JSON, CSV or Excel.

⚠️ Limits

• Heatmaps for coins other than BTC, and heatmap ranges other than 24h (48h for model 3), need a CoinGlass login and are not available here.
• Level and cluster sizes are the values CoinGlass publishes; the actor does not convert units.
• Data is a snapshot of what CoinGlass shows at run time; past heatmaps are not available.