
$0.01308per call
Every call costs the same.
You aren't charged for failed calls. A wallet payment for a failed call is refunded.
About this endpoint
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.
Query parameters
Response types
More from Surf API
- KOL rankingGET/gateway/v1/smart-money/kol/ranking$0.01308 per callFixed
- Liquidation chartGET/gateway/v1/market/liquidation/chart$0.01308 per callFixed
- Blockchain SQL queryPOST/gateway/v1/onchain/sql$0.02616 per callFixed
- KOL call historyGET/gateway/v1/smart-money/kol/history$0.01308 per callFixed
- Order book depthGET/gateway/v1/exchange/depth$0.00654 per callFixed
- Latest company financialsGET/gateway/v1/equity/latest-financialsUp to $0.03924 per callResponse-based
- Web page fetchGET/gateway/v1/web/fetch$0.00654 per callFixed
- Matched market pairsGET/gateway/v1/prediction-market/matching/pairs$0.02616 per callFixed
- Polymarket wallet positionsGET/gateway/v1/prediction-market/polymarket/positions$0.02616 per callFixed
- Hyperliquid trader leaderboardGET/gateway/v1/hyperliquid/leaderboard$0.02616 per callFixed
- Perpetual contract snapshotGET/gateway/v1/exchange/perp$0.00654 per callFixed
- KOL activityGET/gateway/v1/smart-money/kol/activity$0.01308 per callFixed