Skip to main content
GET
Get current user balances across all currencies

Authorizations

Authorization
string
header
required

Enter Auth0 JWT token

Headers

Zuba-Account-Id
string<uuid>

Optional. Names an owned sub-account (UUID) to act on. Omit to act at the master (tenant) level. Naming an account this key does not own returns 403 not_account_owner.

Response

User balances retrieved successfully. Returns balance details for all currency accounts.

balances
object[]
required

List of balances by currency

clientId
string
required

Client ID

Example:

"client456"

primaryCurrency
string
required

Primary currency

Example:

"EUR"

userId
string
required

User ID

Example:

"user123"

calculatedAt
string

Timestamp of balance calculation

Example:

"2025-10-29T12:00:00Z"

totalValueEur
string

Indicative total of all balances converted to EUR at the latest stored mid rates (stablecoins valued at their fiat peg). Omitted when no rate is available to value a held non-zero balance. Not an accounting figure: derive reconciliation totals from the per-currency balances.

Example:

"5000.00"