> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/liquidations/get-liquidated-positions-by-liquidator.md).

# 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
}
```
