liquidation_feed

Most recent liquidation events across ALL futures symbols, newest first. The REST counterpart to the /ws/v1/liquidation/feed WebSocket firehose. Use to find recent large liquidations across the entire market.

Usage hints:

• Filter by exchange or base to narrow scope
• Use minVolumeUsd to filter for whale-sized liquidations only (e.g., 100000 for $100K+)
• Pair with WebSocket /ws/v1/liquidation/feed for live updates

REST endpoint

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

Parameters

Name	Type	Required	Default	Description	Example
exchange	string	no		Exchange filter	"..."
base	string	no		Base asset filter (case-insensitive)	"..."
minVolumeUsd	number	no		Minimum VolumeUsd filter	0
limit	integer	no	100	Number of events (1-1000) (default: 100)	100

Example invocation

JSON-RPC tools/call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "liquidation_feed",
    "arguments": {
      "limit": 100
    }
  }
}