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.
Request
- Base URLhttps://api.asksurf.ai
- AuthHTTP bearer
Query parameters
Exchange name. Can be Binance, OKX, Bybit, Bitget, Hyperliquid, Gate, HTX, Bitmex, Bitfinex, CoinEx, Aster, or Lighter.
Token ticker symbol like BTC or ETH
Minimum liquidation amount in USD
Filter by liquidation side. Omit to return both.
Field to sort results by
Sort order
Results per page
Pagination offset
Start of time range (inclusive). Accepts Unix seconds (1704067200) or date string (2024-01-01)
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.
Response
OK
Example response
{
"$schema": "https://example.com/schemas/DataResponseLiquidationOrderItem.json"
}Changes
No recorded changes to this operation across all 12 revisions of this API.