Output Schema
{
"example": {
"as_of": "2026-10-20T00:00:00.000Z",
"at_risk": [
{
"as_of": "2026-10-19T23:58:00.000Z",
"long_liq_bands_below": [
{
"band_pct": "-3% to -4%",
"notional_usd": 9100000.5,
"positions": 3,
"px_from": 58418.7,
"px_to": 57816.5
}
],
"mark_px": 60225.5,
"nearest_long_liq": {
"distance_pct": -3.94,
"leverage": 20,
"liquidation_px": 57850.5,
"notional_usd": 4200000.5
},
"nearest_short_liq": {
"distance_pct": 2.93,
"leverage": 10,
"liquidation_px": 61990.5,
"notional_usd": 1800000.5
},
"short_liq_bands_above": [
{
"band_pct": "+2% to +3%",
"notional_usd": 2600000.5,
"positions": 2,
"px_from": 61430,
"px_to": 62032.3
}
],
"status": "ok",
"symbol": "BTC",
"totals": {
"long_notional_usd": 410000000.5,
"short_notional_usd": 380000000.5
},
"tracked_accounts": 150,
"venue": "hyperliquid"
}
],
"billing": "Charged only for this fresh 200. 404, 503 and stale replies are not charged.",
"cascades": [
{
"count": 250,
"duration_s": 184,
"end": "2026-10-19T20:23:04.000Z",
"id": "BTC-S-1760905200000",
"largest_single_usd": 812000.25,
"notional_usd": 20475432.5,
"ongoing": false,
"price_close": 59350.1,
"price_high": 59420,
"price_low": 58101.2,
"price_move_pct": 2.05,
"price_open": 58157.5,
"price_source": "okx 1m candles (USDT-SWAP)",
"severity": "high",
"side": "short",
"start": "2026-10-19T20:20:00.000Z",
"symbol": "BTC",
"threshold_multiple": 10.24,
"venue": "okx"
},
{
"count": 352,
"duration_s": 246,
"end": "2026-10-19T16:10:46.000Z",
"id": "SOL-L-1760890000000",
"largest_single_usd": 61000.5,
"notional_usd": 2324711.75,
"ongoing": false,
"price_close": 68.9,
"price_high": 71.3,
"price_low": 68.5,
"price_move_pct": -3.23,
"price_open": 71.2,
"price_source": "okx 1m candles (USDT-SWAP)",
"severity": "medium",
"side": "long",
"start": "2026-10-19T16:06:40.000Z",
"symbol": "SOL",
"threshold_multiple": 5.81,
"venue": "okx"
}
],
"coverage": [
{
"events_covered_from": "2026-10-19T00:00:05.000Z",
"fills_in_window": 6000,
"last_ok": "2026-10-20T00:00:00.000Z",
"notional_in_window_usd": 83932245.5,
"symbol": "BTC",
"threshold_usd": 2000000
}
],
"disclaimer": "Automated data for AI agents. Not financial advice.",
"filters": {
"limit": 20,
"min_severity": null,
"side": null,
"symbols": null
},
"generated_at": "2026-10-20T00:00:05.000Z",
"method": {
"at_risk": "Hyperliquid large-trader liquidation bands within 10% of mark",
"cascade_rule": ">= 10 same-side liquidations, <= 90s apart, window <= 30 min, notional >= threshold_usd",
"events": "OKX USDT-SWAP public liquidation orders (state=filled), recorded by cryptofeed402 every ~2 min",
"ongoing": "true when the last fill is under 90s old",
"price_move": "OKX 1m candles over the cascade window",
"severity": "notional / threshold_usd: low < 3x, medium 3-10x, high >= 10x",
"side": "long = long positions liquidated (forced sells); short = short positions liquidated (forced buys)"
},
"n_cascades_total": 2,
"n_returned": 2,
"notes": "Binance and Bybit are geo-blocked from this host, so events are OKX-only.",
"route": "/liquidations/cascades",
"schema": "cf402.liq_cascades.v0",
"source": "okx:/api/v5/public/liquidation-orders + okx:/api/v5/market/history-candles + hyperliquid:/info clearinghouseState",
"stale_symbols": [],
"truncated": false,
"window": {
"from": "2026-10-19T00:00:05.000Z",
"hours": 24,
"to": "2026-10-20T00:00:05.000Z"
}
},
"type": "json"
}