Market

Large Liquidation Orders

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.

get/gateway/v1/market/liquidation/order

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

exchange'Binance' | 'OKX' | 'Bybit' | 'Bitget' | 'Hyperliquid' | 'Gate' | 'HTX' | 'Bitmex' | 'Bitfinex' | 'CoinEx' | 'Aster' | 'Lighter'

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

Example:Binance
symbolstring

Token ticker symbol like BTC or ETH

Example:BTC
min_amountstring

Minimum liquidation amount in USD

Example:10000
side'long' | 'short'

Filter by liquidation side. Omit to return both.

Example:long
sort_by'usd_value' | 'timestamp' | 'price'

Field to sort results by

order'asc' | 'desc'

Sort order

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

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseLiquidationOrderItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.