Appearance
Get balances for all accounts​
GET
/v1/account/balances/all
Requires ACCOUNT_BALANCES_READ, granted by TRADING_READ or TRADING_WRITE or TREASURY_READ or TREASURY_WRITE or WITHDRAWALS_WRITE or VALR_PAY_WRITE (bundles)
Returns the balances of your primary account and each of its sub-accounts in one call: every currency with a balance, reserved amount or debt, grouped by account. Accounts with nothing in them are listed with an empty balances array, and your primary account (id 0) comes last. Balances in your payments payout, collections and funding accounts aren't included; use Get payments account balances for those. Call it on your primary account (don't send X-VALR-SUB-ACCOUNT-ID); keys limited to some sub-accounts can't use it.
Responses​
OK
application/json
JSON
[
{
"account": {
"label": "Treasury",
"id": "7340032581337088"
},
"balances": [
{
"currency": "USDC",
"available": "24850.12",
"reserved": "0",
"total": "24850.12",
"updatedAt": "2026-10-22T09:30:12.884Z",
"lendReserved": "0",
"borrowReserved": "0",
"borrowedAmount": "0"
},
{
"currency": "USDT",
"available": "998.5",
"reserved": "0",
"total": "998.5",
"updatedAt": "2026-10-22T10:02:44.319Z",
"lendReserved": "0",
"borrowReserved": "0",
"borrowedAmount": "0"
}
]
},
{
"account": {
"label": "Client Funds",
"id": "7339876125413376"
},
"balances": [
]
},
{
"account": {
"label": "Primary",
"id": "0"
},
"balances": [
{
"currency": "ZAR",
"available": "1265172.33",
"reserved": "25000",
"total": "1290172.33",
"updatedAt": "2026-10-22T14:03:51.207Z",
"lendReserved": "0",
"borrowReserved": "0",
"borrowedAmount": "0"
},
{
"currency": "BTC",
"available": "0.4175",
"reserved": "0",
"total": "0.4175",
"updatedAt": "2026-10-22T14:03:51.207Z",
"lendReserved": "0",
"borrowReserved": "0",
"borrowedAmount": "0"
}
]
}
]
Samples​
Errors
Only the errors common to all signed endpoints.