liquidation

Recent liquidation events for a specific futures symbol on a specific exchange, newest first. Each event shows side (long/short liquidated), size in USD, and price. Critical for identifying forced selling/buying pressure.

Usage hints:

• Both exchange and symbol are required (e.g., binance, BTC-USDT)
• Side='sell' means a long position was liquidated; 'buy' means short liquidated
• Large liquidations often precede or accompany sharp price moves
• Use liquidation_feed for cross-symbol firehose view

REST endpoint

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

Parameters

Name	Type	Required	Default	Description	Example
exchange	string	yes		Exchange identifier	"..."
symbol	string	yes		Exchange-native API symbol	"..."
limit	integer	no	100	Number of events to return (1-1000) (default: 100)	100

Example invocation

JSON-RPC tools/call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "liquidation",
    "arguments": {
      "exchange": "...",
      "symbol": "...",
      "limit": 100
    }
  }
}