Large Liquidation Orders

GET/gateway/v1/market/liquidation/order

Returns individual large liquidation orders above a USD threshold (`min_amount`, default 10000).

Filters: `exchange` and `symbol`.

Pagination: `limit`/`offset` page within a bounded, most-recent window. To page beyond that window, shift the time range: set `to` to `oldest_returned_timestamp + 1` (Unix seconds) and repeat, de-duplicating on `order_id`. `to` is exclusive (returns rows strictly older than `to`), so the `+1` re-includes the boundary second; using the oldest timestamp itself would skip any rows sharing that second. When `offset` exceeds the window the response returns an empty array with `meta.empty_reason` rather than falsely claiming exhaustion.

For aggregate totals and long/short breakdown by exchange, use `/market/liquidation/exchange-list`. For historical liquidation charts, use `/market/liquidation/chart`.

Query Parameters

exchangeenum<string>

Exchange name. Can be `Binance`, `OKX`, `Bybit`, `Bitget`, `Hyperliquid`, `Gate`, `HTX`, `Bitmex`, `Bitfinex`, `CoinEx`, `Aster`, or `Lighter`.

Available options:BinanceOKXBybitBitgetHyperliquidGateHTXBitmexBitfinexCoinExAsterLighter

Example: Binance

symbolstring

Token ticker symbol like `BTC` or `ETH`

Example: BTC

min_amountstring

Minimum liquidation amount in USD

Example: 10000

sideenum<string>

Filter by liquidation side. Omit to return both.

Available options:longshort

Example: long

sort_byenum<string>

Field to sort results by

Available options:usd_valuetimestampprice

orderenum<string>

Sort order

Available options:ascdesc

limitinteger

Results per page

offsetinteger

Pagination offset

fromstring

Start of time range (inclusive). Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`)

Example: 2024-01-01

tostring

End of time range, exclusive (returns rows strictly older than `to`). Accepts Unix seconds (`1706745600`) or date string (`2024-02-01`). To page backward, set this to the oldest returned `timestamp` + 1 and de-duplicate on `order_id`.

Example: 2024-02-01

Large Liquidation Orders

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/market/liquidation/order?exchange=Binance&symbol=BTC&min_amount=10000&side=long&from=2024-01-01&to=2024-02-01', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataResponseLiquidationOrderItem.json",
  "data": [
    {
      "base_asset": "<string>",
      "exchange": "<string>",
      "order_id": "<string>",
      "price": 123,
      "side": "<string>",
      "symbol": "<string>",
      "timestamp": 123,
      "usd_value": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>",
    "has_more": true,
    "limit": 123,
    "offset": 123,
    "total": 123,
    "watermark": 123
  }
}