Skip to main content

​
GET /v1/liquidations

Returns recent liquidation events and 24-hour summary statistics.
Most exchanges only provide liquidation data via WebSocket, not REST. This endpoint returns cached data from exchanges that support REST-based liquidation queries. Real-time liquidation feeds require WebSocket integration (coming soon).

​
Query Parameters

​
symbol
string
Filter by symbol. Omit for all.

​
Example

curl "https://api.crypton.dev/v1/liquidations?symbol=BTC"

{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": {
    "recent": [
      {
        "exchange": "binance",
        "symbol": "BTC",
        "side": "long",
        "size_usd": 500000.00,
        "price": 70500.00,
        "timestamp": 1709639900000
      }
    ],
    "total_24h_usd": 125000000.00,
    "long_liquidated_24h": 80000000.00,
    "short_liquidated_24h": 45000000.00
  }
}

​
Response Fields

​
data.recent
array
Recent liquidation events.
​
data.total_24h_usd
number
Total liquidation volume in last 24h (USD).
​
data.long_liquidated_24h
number
Long positions liquidated in last 24h (USD).
​
data.short_liquidated_24h
number
Short positions liquidated in last 24h (USD).

​
Field Reference

FieldTypeDescriptionGranularityExample
exchangestringExchange where liquidation occurredReal-time (when available)"binance"
symbolstringLiquidated symbol (base asset)—"BTC"
sidestringPosition direction that was liquidated: "long" or "short"—"long"
size_usdnumberLiquidation size in USDPer event500000.00
pricenumberPrice at which liquidation was triggeredPer event70500.00
timestampintegerUnix ms when liquidation occurredPer event1709639900000
total_24h_usdnumberTotal liquidation volume across all exchanges in last 24h~60s aggregated125000000.00
long_liquidated_24hnumberLong positions liquidated in 24h (USD)~60s aggregated80000000.00
short_liquidated_24hnumberShort positions liquidated in 24h (USD)~60s aggregated45000000.00

​
Data Sources

Currently limited — most exchanges (Binance, OKX, Bybit) only expose liquidation data via WebSocket streams, not REST. This endpoint returns cached data from exchanges with REST support. Full real-time liquidation feeds via WebSocket integration are planned for Phase 2.

​
Live Testing

# All recent liquidations
curl -s "https://api.crypton.dev/v1/liquidations" | jq .

# BTC liquidations only
curl -s "https://api.crypton.dev/v1/liquidations?symbol=BTC" | jq .