v1

latestOpenAPI 3.0.32026-08-04850206.9 KB

Liquidations

Liquidation feed

The raw liquidation feed (~last 48h, then pruned), newest first. Source coverage is currently OKX swap markets. Prices are decimal strings. meta carries the pagination fields plus a retention and note.

get/api/v1/liquidations

Query parameters

pageinteger nullable

Page number (1-based). Must be at least 1.

Example:1

Page number (1-based). Must be at least 1.

per_pageinteger nullable

Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.

Example:50

Rows per page. The cap is plan-based (Free 100, Starter/Pro 250); exceeding it returns 422 rather than clamping. Must be at least 1. Must not be greater than 100.

exchangestring nullable

Restrict to a single exchange by slug. Source coverage is currently OKX swap markets. Must match the regex /^[a-z0-9-]{1,120}$/.

Example:okx

Restrict to a single exchange by slug. Source coverage is currently OKX swap markets. Must match the regex /^[a-z0-9-]{1,120}$/.

instrument'future' | 'option' | 'swap' | 'spot' | 'margin' nullable

Instrument type: future, option, swap, spot or margin.

Example:swap

Instrument type: future, option, swap, spot or margin.

position'long' | 'short' nullable

Liquidated position side: long or short.

Example:short

Liquidated position side: long or short.

order'buy' | 'sell' nullable

Fill side that triggered the liquidation: buy or sell.

Example:buy

Fill side that triggered the liquidation: buy or sell.

symbolstring nullable

Prefix match on the venue instId (e.g. BTC matches BTC-USDT-SWAP). Must match the regex /^[A-Za-z0-9$.-]{1,25}$/.

Example:BTC

Prefix match on the venue instId (e.g. BTC matches BTC-USDT-SWAP). Must match the regex /^[A-Za-z0-9$.-]{1,25}$/.

min_usdnumber nullable

Only liquidations with a USD value at or above this threshold. Must be at least 0.

Example:1000

Only liquidations with a USD value at or above this threshold. Must be at least 0.

Response

Example response

{
  "data": [
    {
      "symbol": "NEAR-USDT-SWAP",
      "exchange": {
        "id": 20,
        "slug": "okx",
        "name": "OKX"
      },
      "instrument": "swap",
      "position": "short",
      "order": "buy",
      "price": "2.245",
      "value_usd": 5727.73,
      "quantity": 259.1,
      "liquidated_at": "2026-06-21T07:39:41+00:00"
    }
  ],
  "meta": {
    "current_page": 1,
    "per_page": 50,
    "total": 4681,
    "last_page": 94,
    "retention": "~48 hours (raw feed is pruned)",
    "note": "Source coverage: OKX swap markets."
  }
}