> 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-info.md).

# 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.
