Skip to main content

​
GET /v2/liquidations

Not yet implemented. Liquidation data requires WebSocket feeds from Binance, OKX, and Bybit. All exchanges currently report has_liquidations: false. This endpoint will return empty arrays until WebSocket integration is complete.

​
Query Parameters

​
exchange
string
Exchange ID.
​
symbol
string
Filter by symbol.

​
Planned Response

{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": [
    {
      "exchange": "binance",
      "symbol": "BTCUSDT",
      "side": "long",
      "quantity": 1.5,
      "price": 70500.00,
      "timestamp": 1709640000000
    }
  ]
}

​
Field Reference (Planned)

FieldTypeDescriptionGranularityExample
exchangestringSource exchangeReal-time via WebSocket"binance"
symbolstringLiquidated trading pairPer event"BTCUSDT"
sidestring"long" or "short" — position that was liquidatedPer event"long"
quantitynumberLiquidation size in base assetPer event1.5
pricenumberLiquidation trigger price (USD)Per event70500.00
timestampintegerUnix ms of liquidation eventPer event1709640000000

​
Data Sources

Not yet implemented. Will require WebSocket feeds from Binance (!forceOrder@arr), OKX (liquidation channel), and Bybit (liquidation stream). REST endpoints don’t expose this data on most exchanges.