> 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-positions-under-liquidation.md).

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