Liquidation Heatmap

GET /liquidation/heatmap/:symbol

Liquidation cluster analysis with cascade risk assessment for a perpetual futures market.

Cost: $0.05 USDC

Path Parameters

Param	Type	Description
symbol	string	Futures symbol (e.g. BTC, ETH, SOL)

Request Example

curl -H "x-payment: <proof>" \
  https://api.foursec.xyz/liquidation/heatmap/BTC

const res = await fetchWithPayment(
  "https://api.foursec.xyz/liquidation/heatmap/BTC"
);
const data = await res.json();

Response

{
  "symbol": "BTC",
  "current_price": 57800,
  "open_interest_usd": 12500000000,
  "cascade_risk": "medium",
  "leverage_clusters": [
    {
      "leverage": "10x",
      "liquidation_price": 52000,
      "distance_pct": -10.03,
      "oi_at_risk_usd": 450000000,
      "side": "long"
    },
    {
      "leverage": "25x",
      "liquidation_price": 55600,
      "distance_pct": -3.81,
      "oi_at_risk_usd": 180000000,
      "side": "long"
    },
    {
      "leverage": "50x",
      "liquidation_price": 56650,
      "distance_pct": -1.99,
      "oi_at_risk_usd": 95000000,
      "side": "long"
    },
    {
      "leverage": "100x",
      "liquidation_price": 57220,
      "distance_pct": -1.00,
      "oi_at_risk_usd": 42000000,
      "side": "long"
    }
  ],
  "risk_summary": {
    "total_oi_at_risk_usd": 767000000,
    "oi_at_risk_pct": 6.14,
    "cascade_risk": "medium",
    "cascade_risk_reason": "6.1% of OI within 10% price range"
  },
  "timestamp": "2026-07-08T14:30:00Z"
}

Cascade Risk Levels

Level	Condition
high	>10% of OI at risk within 5% price range
medium	5–10% of OI at risk within 10% price range
low	<5% of OI at risk

Data Source

Binance FAPI (price, open interest, long/short ratio). Leverage tiers: 5x, 10x, 25x, 50x, 100x. Cache TTL: 15 seconds.

Related Endpoints

• Recent Liquidations — real-time event stream
• Liquidation Alert — webhook on cascade risk