Developer Portal
Trader APIsHTTP APIHistory

List DealsGET

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.

View as Markdown
GET
/accounts/{account_id}/history/deals

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID to fetch deal history for

Query Parameters

fromstring

Inclusive start date (YYYY-MM-DD, UTC). Omit for all history.

toRequiredstring

Inclusive end date (YYYY-MM-DD, UTC).

limitinteger

Maximum number of deals to return in one page (default 25, max 500)

Default: 25Minimum: 1Maximum: 500
next_tokenstring

Opaque cursor from the previous page's next_token. Send it unchanged, with the same from/to; omit it for the first page.

curl -X GET "http://localhost:8081/api/v1/accounts/acc_123456/history/deals?from=2025-08-03&to=2025-08-03&limit=25&next_token=%3Cstring%3E" \
  -H "Authorization: Bearer <token>"

Successfully retrieved account history

{
  "deals": [
    {
      "id": "string",
      "user_id": "uuid-1234-4333",
      "symbol_name": "string",
      "comment": "string",
      "client_deal_id": "uuid-5433-2356",
      "account_id": "string",
      "order_id": "string",
      "position_id": "string",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "symbol_id": "string",
      "volume": 0.1,
      "amount": 0.1,
      "amount_raw": 0.1,
      "exchange_rate": 0.1,
      "close_price": 0.1,
      "close_price_raw": 0.1,
      "open_price": 0.1,
      "open_price_raw": 0.1,
      "commission": 0.1,
      "commission_raw": 0.1,
      "action": "DEAL_ACTION_BALANCE",
      "direction": "DEAL_DIRECTION_IN"
    }
  ],
  "next_token": "string"
}

Exchange Rates

Returns the current conversion rate between two currencies. Use it to convert balances, PnL or margin figures from an account's currency into another, for example USD to EUR.

Balance History

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.