---
title: "Large Liquidation Orders"
method: GET
path: "/gateway/v1/market/liquidation/order"
tags: ["Market"]
---

# Large Liquidation Orders

`GET /gateway/v1/market/liquidation/order`

## Request

- Base URL: `https://api.asksurf.ai`
- URL: `https://api.asksurf.ai/gateway/v1/market/liquidation/order`
- Auth: HTTP bearer

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

- `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`.
- `symbol` string: Token ticker symbol like `BTC` or `ETH`
- `min_amount` string: Minimum liquidation amount in USD
- `side` 'long' | 'short': Filter by liquidation side. Omit to return both.
- `sort_by` 'usd_value' | 'timestamp' | 'price': Field to sort results by
- `order` 'asc' | 'desc': Sort order
- `limit` integer: Results per page
- `offset` integer: Pagination offset
- `from` string: Start of time range (inclusive). Accepts Unix seconds (`1704067200`) or date string (`2024-01-01`)
- `to` string: 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 `200`

OK

- DataResponseLiquidationOrderItem
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` LiquidationOrderItem[], nullable, required
    - `base_asset` string, required: Base token symbol like `BTC`
    - `exchange` string, required: Exchange name like `Binance` or `OKX`
    - `order_id` string, required: Deterministic fingerprint for this liquidation row
    - `price` number, double, required: Liquidation execution price (USD)
    - `side` string, required: Liquidation side: `long` or `short`
    - `symbol` string, required: Full trading pair like `BTCUSDT`
    - `timestamp` integer, required: Unix timestamp in seconds
    - `usd_value` number, double, required: Liquidated position size (USD)
  - `meta` OffsetMeta, required
    - `cached` boolean, required: Whether this response was served from cache
    - `credits_used` integer, required: Credits deducted for this request
    - `empty_reason` string: Hint explaining why the data array is empty, when applicable
    - `has_more` boolean: Whether more items may exist beyond this response. For offset-paged endpoints, continue with a larger offset. For time-series endpoints without offset/cursor controls, true means the requested time range hit an upstream cap; narrow from/to to continue. Omitted when exhaustion cannot be proven.
    - `limit` integer, required: Maximum number of items returned in this response
    - `offset` integer, required: Number of items skipped (pagination offset)
    - `total` integer: Total number of matching items (before pagination). Omitted when total is unknown.
    - `watermark` integer: Warehouse watermark (Unix seconds) this response was computed at, on warehouse-backed endpoints (e.g. Hyperliquid /trades/aggregate) — rows up to this time come from the warehouse, newer rows from the live tail. Omitted elsewhere.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api.md) - [All operations](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/asksurf/apis/asksurf-public-rest-api/revisions/91774fdd5302?raw)