Developer Portal
Trader APIsHTTP APIHistory

Balance HistoryGET

Returns the most recent balance changes for the account, oldest first, up to `points` items. Each item is the balance right after the change and the `reason` for it. Credit and the P&L of open positions are not included. An account with no history returns an empty `data` array.

View as Markdown
GET
/accounts/{account_id}/balance-history

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID to fetch the balance history for

Query Parameters

pointsinteger

Maximum number of balance changes to return (1-100)

Default: 60Minimum: 1Maximum: 100
curl -X GET "http://localhost:8081/api/v1/accounts/acc_123456/balance-history?points=60" \
  -H "Authorization: Bearer <token>"

Balance changes, oldest first

{
  "data": [
    {
      "time": "2026-09-21T08:00:03Z",
      "balance": 10000,
      "reason": "balance"
    },
    {
      "time": "2026-09-22T13:42:10Z",
      "balance": 10125.4,
      "reason": "trade"
    },
    {
      "time": "2026-09-23T00:00:00Z",
      "balance": 10123.15,
      "reason": "swap"
    }
  ]
}

List Deals

Returns one page of deal history for the authenticated user, newest first. There is no maximum date range. When more deals may match, the response carries `next_token`; pass it back to fetch the next page, which can be empty. An absent `next_token` means this is the last page.

List Orders

Returns one page of order history for the authenticated user, newest creation time first. There is no maximum date range. When more orders match, the response carries `next_token`; pass it back to fetch the next page. An absent `next_token` means this is the last page.