TradePortfolio
DocsLiquidation Events
Docs

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 live liquidation feeds via polling, 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

NameTypeRequiredDescription
sincestring–Unix timestamp in milliseconds. Bypasses the snapshot and queries ClickHouse directly for events after this time.
limitinteger–Maximum number of events to return.
min_usdfloat–Minimum USD value filter (snapshot path only).
exchangestring–Comma-separated lowercase exchange slugs.
symbolstring–Comma-separated base symbols, e.g. BTC,ETH. Mutually exclusive with exclude_symbol.
exclude_symbolstring–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.

Related