Recent liquidations
recent_liquidationsRecent forced liquidations of one asset's USDT perpetual on OKX (the only venue reachable from the US that publishes a liquidation feed): long vs short liquidated count, size and USD value over the last 0.25–24 hours, the largest ones, an hourly breakdown, and where they cleared relative to the current mark price in adjustable % bands. These are realized liquidations, not estimated liquidation levels. Reports how much of the window the feed covered. Fails (and is not charged) if OKX doesn't answer or lists no such perpetual. Costs $0.003 USDC per call.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"symbol": "<symbol>"
},
"name": "recent_liquidations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | No | Look-back window in hours, 0.25–24 (default 4) | |
| symbol | Yes | Base asset or pair, e.g. 'BTC', 'ETH', 'SOLUSDT' | |
| bucketPct | No | Width of the price bands around the mark price, in %, 0.1–5 (default 0.5) |