Get Liquidated Positions Info

#Endpoint

GET /v1/public/liquidated_positions

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

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

Rate limit: 10 requests per second per IP address.

Returns historical records for positions fully closed by the liquidation engine after account margin was exhausted.

#Query parameters

• symbol (string, optional) — limit results to a market, for example PERP_ETH_USDC.
• start_t, end_t (strings, optional) — range boundaries as 13-digit Unix timestamps in milliseconds.
• page (string, optional) — requested page number; starts at 1.
• size (string, optional) — number of records per page.

#Response

HTTP 200 — application/json. success (boolean) and data (object) are required. data.meta contains required integer fields total, records_per_page, and current_page. data.rows is a required array.

• Each row requires timestamp (integer), liquidation_id (integer), and transfer_amount_to_insurance_fund (integer). type is a string.
• positions_by_perp is a required array. Each item requires symbol (string), position_qty (integer), liquidator_fee (number), cost_position_transfer (integer), transfer_price (integer), insurance_fund_fee (number), and abs_insurance_fund_fee (integer). seq (number) and abs_liquidator_fee (integer) are optional.

timestamp at the response root is the server response time in milliseconds (integer).

{
  "success": true,
  "data": {
    "meta": { "total": 9, "records_per_page": 25, "current_page": 1 },
    "rows": [{
      "timestamp": 1683802462092,
      "liquidation_id": 29,
      "transfer_amount_to_insurance_fund": 0,
      "positions_by_perp": [{
        "symbol": "PERP_ETH_USDC",
        "position_qty": 0,
        "liquidator_fee": 0.015,
        "cost_position_transfer": 0,
        "transfer_price": 1860,
        "insurance_fund_fee": 0.011999,
        "abs_insurance_fund_fee": 0,
        "seq": 1730181536341943600,
        "abs_liquidator_fee": 0
      }],
      "type": "liquidated"
    }]
  },
  "timestamp": 1702989203989
}

This public endpoint does not require account-signing headers.