> 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/assets-withdraw-settle-pnl/get-pnl-settlement-history.md).

# Get PnL Settlement History

### Endpoint

`GET /v1/pnl_settlement/history`

Mainnet: `https://api.orderly.org/v1/pnl_settlement/history`

Testnet: `https://testnet-api.orderly.org/v1/pnl_settlement/history`

Rate limit: 20 requests per second.

Returns PnL settlement records for the authenticated 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

* `start_t`, `end_t` (integers, optional).
* `page` (integer, optional) — page number starting at 1.
* `size` (integer, optional) — number of records per page.

### Response

HTTP 200 — application/json. `success` is a required boolean. `data.meta` contains required integer fields `total`, `records_per_page`, and `current_page`. `data.rows` is a required array; each record can contain `id` (integer), `old_balance`, `new_balance`, and `settled_amount` (numbers), plus `requested_time` and `settled_time` (integers in Unix milliseconds). Each `symbols` entry has required `symbol` (string) and `settled_amount` (integer). The root `timestamp` is server time in milliseconds (integer).

```
{
  "success": true,
  "data": {
    "meta": { "total": 9, "records_per_page": 25, "current_page": 1 },
    "rows": [{
      "id": 10001,
      "old_balance": 4050,
      "new_balance": 3050,
      "settled_amount": -500,
      "requested_time": 1575014255089,
      "settled_time": 1575014255910,
      "symbols": [{ "symbol": "PERP_BTC_USDC", "settled_amount": -500 }]
    }]
  },
  "timestamp": 1702989203989
}
```
