LiquidationClusterSqueezeRiskIntel
Real-time liquidation heatmap and squeeze risk scoring for BTC, ETH, and SOL perpetual futures across Binance, Bybit, OKX, and Hyperliquid.
Community: Submitted by a user or imported; check the owner before granting accessOnlineNo sign-inGlobalFreeRead-only
What it can do
- Get Liquidation Clusters: Return liquidation cluster geometry — the CoinGlass heatmap equivalent. For the specified venue, symbol, and time resolution, aggregates all liquidation events in the lookbac
- Get Squeeze Risk Score: Return the aggregate squeeze risk score for a venue/symbol pair. Combines cluster geometry across all 5 resolutions (1m through 4h) to produce a holistic squeeze risk assessmen
- Get Cross Venue Liquidation Summary: Cross-venue liquidation summary for BTC, ETH, or SOL across Binance, Bybit, and OKX. Queries all three supported venues simultaneously and returns: - Per-venue clu
What data it sees
Do you need an account
No: the server works without sign-in
Real-time liquidation heatmap and squeeze risk scoring for BTC, ETH, and SOL perpetual futures across Binance, Bybit, OKX, and Hyperliquid. Returns price-bucketed liquidation clusters with per-bucket squeeze probability scores (0–100) based on cluster density, funding rate alignment, OI velocity, and price proximity.
Server tool list (4)
Raw names from tools/list. Only developers need these.
| get_liquidation_clusters | Return liquidation cluster geometry — the CoinGlass heatmap equivalent. For the specified venue, symbol, and time resolution, aggregates all liquidation events in the lookback window into price-bucketed clusters. Each cluster includes: - long and short notional (USD) that was liquidated at that price level - cumulative liquidation value up to that price level - squeeze probability score (0–100) with rating label - distance from current mark price Parameters ---------- venue : str Exchange: "binance" | "bybit" | "okx" | "hyperliquid" symbol : str "BTC", "ETH", or "SOL" resolution : str Time bucket size: "1m" | "5m" | "15m" | "1h" | "4h" lookback_minutes : int How many minutes of history to aggregate (default 60). For 4h resolution, recommend 240–1440. Max 129600 (90 days). Historical cluster data is retained for 365 days. Returns ------- Full cluster geometry with provenance, confidence, freshness, and evidence. |
| get_squeeze_risk_score | Return the aggregate squeeze risk score for a venue/symbol pair. Combines cluster geometry across all 5 resolutions (1m through 4h) to produce a holistic squeeze risk assessment. The score indicates how likely the current market structure is to produce a liquidation cascade in the near term. Includes a score breakdown showing contribution from each component: - cluster_density (0–40): how large current clusters are vs 30-day baseline - funding_alignment (0–20): whether funding rate aligns with cluster side - oi_velocity (0–20): how fast OI is growing (more leverage = more risk) - price_proximity (0–20): how close the largest cluster is to current price Parameters ---------- venue : str "binance" | "bybit" | "okx" | "hyperliquid" symbol : str "BTC", "ETH", or "SOL" |
| get_cross_venue_liquidation_summary | Cross-venue liquidation summary for BTC, ETH, or SOL across Binance, Bybit, and OKX. Queries all three supported venues simultaneously and returns: - Per-venue cluster geometry for each requested resolution - Consensus squeeze score (volume-weighted average across venues) - Cross-venue divergence score (0–1): how much venues disagree (high divergence may indicate venue-specific forced selling) Note: Hyperliquid is included in the response structure but will always show no data — no public market-wide liquidation event feed exists for that venue. Parameters ---------- symbol : str "BTC", "ETH", or "SOL" resolutions : list[str], optional Subset of ["1m","5m","15m","1h","4h"]. Defaults to ["5m","1h","4h"]. |
| refresh_clusters | Force an immediate re-aggregation of cluster geometry for a venue/symbol pair. The pipeline automatically refreshes every few seconds, so this is only needed if you want guaranteed freshness before a time-critical query. Parameters ---------- venue : str "binance" | "bybit" | "okx" | "hyperliquid" symbol : str "BTC", "ETH", or "SOL" |