Get Positions Under Liquidation

#Endpoint

GET /v1/public/liquidation

Mainnet: https://api.orderly.org/v1/public/liquidation

Testnet: https://testnet-api.orderly.org/v1/public/liquidation

Rate limit: 10 requests per second per IP address.

Returns positions that are currently being closed by the liquidation engine because their margin is below the maintenance-margin requirement.

#Query parameters

• start_t (number, optional) — start of the time range, as a 13-digit Unix timestamp in milliseconds.
• end_t (number, optional) — end of the time range, as a 13-digit Unix timestamp in milliseconds.
• page (integer, optional) — page number, starting at 1.
• size (integer, optional) — page size; defaults to 60.

#Response

HTTP 200 — application/json.

success is a required boolean; data is a required object. data.meta contains required integer fields total, records_per_page, and current_page (starting at 1). data.rows is a required array. Each row can include timestamp (integer), type (string), liquidation_id (integer), and positions_by_perp (array).

Each positions_by_perp item contains symbol (string), position_qty (number), and liquidator_fee (number).

{
  "success": true,
  "data": {
    "meta": { "total": 9, "records_per_page": 25, "current_page": 1 },
    "rows": [{
      "timestamp": 1685298157704,
      "type": "liquidated",
      "liquidation_id": 1730,
      "positions_by_perp": [{
        "symbol": "PERP_BTC_USDC",
        "position_qty": -0.22457,
        "liquidator_fee": 0.015
      }]
    }]
  },
  "timestamp": 1702989203989
}

This is a public read-only endpoint; no account-signing headers are required.