get_liquidations_recent
Read-only
Recent cross-exchange liquidation notional estimates for a symbol. Answers: "How much got liquidated on ETH in the last hour?", "Mostly longs or shorts?". Covers Binance, Bybit, OKX (not Hyperliquid). USD values are base quantity multiplied by each venue's source reference price; Bybit/OKX expose bankruptcy price, so these are estimates rather than execution notionals. Returns whole-dollar estimates, long_ratio (0..1 share of LONGS liquidated), notional_semantics, and event count for the window (window_s, default 3600, max 86400). Read-only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Asset symbol: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC or ENA (case-insensitive; a `USDT` suffix is accepted). | |
| window_s | No | Look-back window in seconds, 1..=86400 (default 3600). Values beyond 24 h are rejected, not clamped. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | Upstream read time, RFC3339 UTC. | |
| symbol | Yes | Uppercase symbol, e.g. `BTC`. | |
| long_usd | Yes | Liquidated LONG notional, USD (whole dollars). | |
| n_events | Yes | Number of liquidation events in the window. | |
| window_s | Yes | The window actually used, seconds (upstream clamps to at most 86400). | |
| short_usd | Yes | Liquidated SHORT notional, USD (whole dollars). | |
| usd_total | Yes | Total liquidated notional in the window, USD (whole dollars). | |
| long_ratio | No | Share of LONGS liquidated, RATIO 0..1 (0.71 = 71 % longs). `null` when the window had zero notional. | |
| notional_semantics | Yes | These are estimates (`base qty × source reference price`), not exchange- reported execution notionals. Bybit/OKX publish bankruptcy prices. |