liquidation_symbol_history

Bucketed long/short liquidation USD over time for a single (base, quote) pair, joined with the futures-candle close as a reference price line. Visualizes liquidation cascades against price action.

Usage hints:

• symbol is required (e.g., BTC-USDT)
• Intervals: 5m, 15m, 1h; windows: 24h, 72h, 7d
• Default exchange falls back to Binance if not specified
• Cached ~30s server-side

REST endpoint

GET /api/v1/liquidation/symbol-history — see REST reference.

Parameters

Name	Type	Required	Default	Description	Example
symbol	string	yes		Base asset	"..."
quote	string	no	USDT	Quote asset (default: USDT)	"USDT"
exchange	string	no		Optional exchange filter for the liquidation aggregation. The price line stays on Binance unless this is set.	"..."
interval	string	no	5m	Bucket interval (5m, 15m, 1h) (default: 5m)	"5m"
window	string	no	24h	Lookback window (24h, 72h, 7d) (default: 24h)	"24h"

Example invocation

JSON-RPC tools/call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "liquidation_symbol_history",
    "arguments": {
      "symbol": "...",
      "quote": "USDT",
      "interval": "5m",
      "window": "24h"
    }
  }
}