PnL History
View historical profit and loss data
Get PnL History
GET /v1/account/pnl-history?period=daily&limit=30
Authorization: Bearer <token>Query Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
period | string | No | daily | Grouping period: daily, weekly, or monthly |
limit | number | No | 30 | Number of periods to return |
Response:
{
"ok": true,
"history": [
{
"date": "2026-03-27",
"pnl": -2.34,
"volume": 15234.56,
"trades": 12
},
{
"date": "2026-03-26",
"pnl": 45.67,
"volume": 28901.23,
"trades": 8
}
],
"summary": {
"totalPnl": 43.33,
"totalVolume": 44135.79,
"totalTrades": 20
}
}| Field | Description |
|---|---|
date | Period start date (YYYY-MM-DD or YYYY-MM for monthly) |
pnl | Net realized PnL for the period (after fees) |
volume | Total trading volume in USDT |
trades | Number of executed trades |
summary | Aggregated totals across all returned periods |