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​