How to get Balances for a specific Account

To retrieve the balances for a specific account, use the POST /api/v1/account/balances method (or the appropriate endpoint as defined in your API).

This method returns a list of all currencies and their corresponding balances held within the specified account.

Request

{
    "account": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": 1743110400000
}

• account (string, required): The unique identifier of the account for which to retrieve balances.

• timestamp (integer, int64, required): Current Unix timestamp in milliseconds (UTC). The value must be within 3 minutes of the server's current time.

Response (200 OK)

{
  "account": "123e4567-e89b-12d3-a456-426614174000",
  "name": "Test Account",
  "ownerId": "987fcdeb-51a2-43d7-9b8c-234567890abc",
  "balances": [
    {
      "currency": "USDT_TRX",
      "amount": 1500.75
    },
    {
      "currency": "BTC",
      "amount": 0.025
    },
    {
      "currency": "ETH",
      "amount": 1.5
    }
  ]
}

Response Field Descriptions:

Field	Type	Description
account	string	The unique identifier of the account
name	string	The display name of the account
ownerId	string (UUID)	The unique identifier of the user who owns the account
balances	array	A list of currency balances held in the account
balances[].currency	string	The currency code (e.g., USDT_TRX, BTC, ETH)
balances[].amount	number	The balance amount for the specified currency