Get Customer Balances

GET

/api/v1/wallets/balances

Returns the customer's current balances per currency across their wallets.

Query Parameters

Field	Type	Description
`customerId`	`string (uuid)`	Unique identifier of the customer whose balances you want — required

Response Fields

Field	Type	Description
`data.balances[].currencyCode`	`string`	Currency ticker (e.g. `USDT`)
`data.balances[].balance`	`number`	Current balance in that currency
`requestId`	`string`	Unique identifier of this API request
`timestamp`	`string (date-time)`	Server timestamp of the response (UTC)

Request

Authorization

Query Params

Header Params

Responses

🟢200

application/json

OK.

Bodyapplication/json

🟠401

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/wallets/balances?CustomerId=' \
--header 'X-API-Key;' \
--header 'X-Signature;' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Body-Hash;'

Response Example

{
    "data": {
        "balances": [
            {
                "currencyCode": "USDT",
                "balance": 1250.75
            },
            {
                "currencyCode": "BTC",
                "balance": 0.0431
            }
        ]
    },
    "requestId": "5e9b31c7f0a84d62ab13c7e4d9f05821",
    "timestamp": "2026-08-21T09:52:47.2310885Z"
}

Modified at 2026-08-22 09:34:55

Get Wallet Address

List Wallets