Recent forced-close events across every derivatives exchange we ingest.

Use this when you need a raw feed of long or short liquidations — the textbook contrarian / squeeze signal. Results are newest-first. Filter by `coin` to isolate a single asset, or by `source` to compare venues (Binance vs Bybit vs OKX). When neither filter is supplied this is identical to the table on `/liquidations`.

Query parameters

All query parameters are optional unless marked required.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

Array<{
  ts: number;                // unix ms
  canonicalSymbol: string;   // "BTCUSDT"
  side: "long" | "short";    // position that got liquidated
  price: number;             // fill price
  qtyUsd: number;            // notional, USD
  source: string;            // exchange key
}>

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/liquidations?coin=BTC&limit=5" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"

{
  "data": [
    {
      "ts": 1744835210123,
      "canonicalSymbol": "BTCUSDT",
      "side": "long",
      "price": 63180.5,
      "qtyUsd": 485231.22,
      "source": "binance_futures"
    },
    {
      "ts": 1744835204411,
      "canonicalSymbol": "BTCUSDT",
      "side": "short",
      "price": 63205.0,
      "qtyUsd": 91220.0,
      "source": "bybit"
    }
  ],
  "meta": { "total": 2, "limit": 5, "offset": 0 }
}

Notes

• Each call costs 1 unit against your tier's per-minute budget.
• Unfiltered calls reuse the same query that powers the `/liquidations` page, so numbers will always reconcile 1:1 with the UI.