Get Liquidated Positions by Liquidator

#Endpoint

GET /v1/client/liquidator_liquidations

Mainnet: https://api.orderly.org/v1/client/liquidator_liquidations

Testnet: https://testnet-api.orderly.org/v1/client/liquidator_liquidations

Rate limit: 10 requests per second per IP address.

Returns liquidation records associated with the authenticated liquidator account.

#Authentication

Send the signed-request headers.

• orderly-timestamp — required; signed-request timestamp in milliseconds.
• orderly-account-id — required; authenticated account ID.
• orderly-key — required; public API key.
• orderly-signature — required; signature generated for the request.

#Query parameters

• symbol (string, optional) — market filter.
• start_t, end_t (numbers, optional) — time-range filters.
• page (number, optional) — page number, starting at 1.
• size (number, optional) — number of records per page.

#Response

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

• A row may contain liquidation_id (integer), timestamp (number), and type (string).
• assigned (number): 1 means assigned to SPV or MM; 0 means claimed.
• positions_by_perp is an array of position records. Fields include symbol (string), abs_liquidator_fee, cost_position_transfer, liquidator_fee, position_qty, and transfer_price (numbers).

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

{
  "success": true,
  "data": {
    "meta": { "total": 9, "records_per_page": 25, "current_page": 1 },
    "rows": [{
      "liquidation_id": 1728,
      "timestamp": 1685154032762,
      "type": "liquidated",
      "assigned": 1,
      "positions_by_perp": [{
        "symbol": "PERP_BTC_USDC",
        "abs_liquidator_fee": 1.152279,
        "cost_position_transfer": 21.002786,
        "liquidator_fee": 0.006,
        "position_qty": 0.00017,
        "transfer_price": 123545.8
      }]
    }]
  },
  "timestamp": 1702989203989
}