Skip to main content
GET
/
api
/
v1
/
liquidations
Liquidation Events
curl --request GET \
  --url https://api.example.com/api/v1/liquidations
Returns individual liquidation events captured in real-time via Binance WebSocket. Each event includes the liquidated side (LONG/SHORT), price, quantity, and USD value.

​
Parameters

ParameterTypeDefaultDescription
symbolstring—Filter by trading pair (optional)
sincestring—ISO 8601 date to filter events after (optional)
limitnumber100Number of events to return (max 500)

​
Example Request

curl -X GET "https://krovn.io/api/v1/liquidations?symbol=BTCUSDT&limit=3" \
  -H "X-API-Key: your_api_key"

​
Example Response

{
  "data": [
    {
      "symbol": "BTCUSDT",
      "side": "LONG",
      "price": "87102.40",
      "quantity": "0.150",
      "usd_value": 13065.36,
      "event_time": "2026-03-21T12:28:15.000Z"
    },
    {
      "symbol": "BTCUSDT",
      "side": "SHORT",
      "price": "87520.80",
      "quantity": "0.085",
      "usd_value": 7439.27,
      "event_time": "2026-03-21T12:25:42.000Z"
    },
    {
      "symbol": "BTCUSDT",
      "side": "LONG",
      "price": "87050.10",
      "quantity": "0.220",
      "usd_value": 19151.02,
      "event_time": "2026-03-21T12:22:08.000Z"
    }
  ]
}
Events are returned in descending order (newest first). Omit the symbol parameter to get liquidations across all tracked coins.