Liquidation Events

Dev

GET /liquidations/events

Returns recent liquidation events across all tracked exchanges, with optional filtering by exchange, symbol, USD minimum, and time cursor. Events are consolidated by (exchange, order_id) when multiple fills map to the same order. Useful for building real-time liquidation feeds, alerting on large events, or studying cascading liquidation patterns.

Authentication

Requires Dev tier or higher. Free tier does not have access (returns 403).

Parameters

Query parameters

Name	Type	Required	Description
`since`	string	–	Unix timestamp in milliseconds. Bypasses the snapshot and queries ClickHouse directly for events after this time.
`limit`	integer	–	Maximum number of events to return.
`min_usd`	float	–	Minimum USD value filter (snapshot path only).
`exchange`	string	–	Comma-separated lowercase exchange slugs.
`symbol`	string	–	Comma-separated base symbols, e.g. BTC,ETH. Mutually exclusive with exclude_symbol.
`exclude_symbol`	string	–	Comma-separated symbols to exclude. Mutually exclusive with symbol.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/liquidations/events?symbol=BTC,ETH&min_usd=100000"

Example response

json

{
  "events": [
    {
      "timestamp": "2026-06-08T05:55:12Z",
      "exchange": "binance",
      "symbol": "BTC",
      "side": "long",
      "price": 71200.00,
      "avg_price": 71195.50,
      "quantity": 2.5,
      "filled_quantity": 2.5,
      "usd_value": 177988.75,
      "status": "filled",
      "oid": "abc123",
      "fill_count": 1
    },
    {
      "timestamp": "2026-06-08T05:54:43Z",
      "exchange": "bybit",
      "symbol": "ETH",
      "side": "long",
      "price": 3820.00,
      "avg_price": 3819.20,
      "quantity": 50.0,
      "filled_quantity": 50.0,
      "usd_value": 190960.00,
      "status": "filled",
      "oid": "def456",
      "fill_count": 1
    }
  ],
  "count": 2
}

Errors

400 — Both symbol and exclude_symbol provided (mutually exclusive).

For authentication errors (401) and rate limit responses (429), see Errors.