Skip to content

Get all non-zero balances

GET
/v1/account/balances/all

Returns the entire portfolio's balances that are greater than 0, grouped by account for the primary account and its subaccounts. Accounts with neither balance nor debt will be returned with an empty array. Can only be called using a primary account API key.

Authorizations

apiKey

Your API key

Type
API Key (header: X-VALR-API-KEY)
+
apiSignature

HMAC SHA512 signature of the request (see Authentication section)

Type
API Key (header: X-VALR-SIGNATURE)
+
apiTimestamp

Request timestamp in milliseconds

Type
API Key (header: X-VALR-TIMESTAMP)

Responses

Portfolio balances retrieved successfully

application/json
JSON
[
{
"account": {
"label": "ox",
"id": "1385226517613019136"
},
"balances": [
{
"currency": "ZAR",
"available": "0",
"reserved": "0",
"total": "15",
"updatedAt": "2025-07-01T10:46:29.408Z",
"lendReserved": "0",
"borrowReserved": "15",
"borrowedAmount": "0"
}
]
},
{
"account": {
"label": "API key test",
"id": "1385148772766830592"
},
"balances": [
]
},
{
"account": {
"label": "Primary",
"id": "0"
},
"balances": [
{
"currency": "ZAR",
"available": "1265172.33437585412",
"reserved": "0",
"total": "1665172.33437585412",
"updatedAt": "2025-07-01T14:14:37.218Z",
"lendReserved": "400000",
"borrowReserved": "0",
"borrowedAmount": "0"
},
{
"currency": "USDC",
"available": "83241.870104015439",
"reserved": "5.5",
"total": "83247.370104015439",
"updatedAt": "2025-07-03T07:19:01.245Z",
"lendReserved": "0",
"borrowReserved": "0",
"borrowedAmount": "0"
}
]
}
]

Playground

Authorization

Samples