liquidation_map

Coinglass-style liquidation map for one perpetual pair. Returns a price-grid breakdown of where leveraged positions would be liquidated, split by leverage tier (10x/25x/50x/100x) and side. Built from current OI + last-24h candle entries.

Usage hints:

• base is required; exchange defaults to binance, quote to USDT
• Read the 'assumptions' field in the response for the modelling disclaimer
• Use to identify likely support/resistance zones from leverage clusters
• Cached ~5s server-side — back-to-back polls are cheap

REST endpoint

GET /api/v1/liquidation/map — see REST reference.

Parameters

Name	Type	Required	Default	Description	Example
exchange	string	no	binance	Exchange (default: binance)	"binance"
base	string	yes		Base asset	"..."
quote	string	no	USDT	Quote asset (default: USDT)	"USDT"

Example invocation

JSON-RPC tools/call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "liquidation_map",
    "arguments": {
      "exchange": "binance",
      "base": "...",
      "quote": "USDT"
    }
  }
}