Developer Portal

List DealsGET

Returns deal history for the authenticated user

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

From date created to fetch deal history for

toRequiredstring

To date created to fetch deal history for

curl -X GET "http://localhost:8081/api/v1/accounts/acc_123456/history/deals?from=2025-08-03&to=2025-08-03" \
  -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"
    }
  ]
}