Liquidation by Exchange

GET/gateway/v1/market/liquidation/exchange-list

Returns liquidation breakdown by exchange in a single ranked snapshot.

Included fields: total, long, and short volumes in USD.

Filters: `symbol` and `time_range` (`1h`, `4h`, `12h`, `24h`).

No pagination and no `interval` — this endpoint does NOT accept `limit`, `offset`, or `interval`. Returns the full exchange list in one response.

Query Parameters

symbolstring

Token ticker symbol like `BTC` or `ETH`

Example: BTC

time_rangeenum<string>

Window to aggregate over for the snapshot: `1h`, `4h`, `12h`, or `24h`. Returns a single snapshot (not a time-series). This endpoint uses `time_range` only — it does NOT accept `interval`.

Available options:1h4h12h24h

Example: 24h

sort_byenum<string>

Field to sort results by

Available options:liquidation_usdlong_liquidation_usdshort_liquidation_usd

Example: liquidation_usd

orderenum<string>

Sort order

Available options:ascdesc

Example: desc

Liquidation by Exchange

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/market/liquidation/exchange-list?symbol=BTC&time_range=24h&sort_by=liquidation_usd&order=desc', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/SimpleListResponseLiquidationExchangeItem.json",
  "data": [
    {
      "exchange": "<string>",
      "liquidation_usd": 123,
      "long_liquidation_usd": 123,
      "short_liquidation_usd": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}