Get balance

GET /institutional/subaccounts/balance

Returns the current balance for the specified subaccount. If not specified, returns the balance for the main account.

info

This is a private endpoint. To send requests, you need to authenticate.

warning

To use this private endpoint, you must use the API key of your main account with the Include all subaccounts.

Rate limit weight points: 5

Request

subaccountId uuid

The unique identifier for the subaccount. If not specified, returns the account balance of the main account.

symbol string

Asset to return the balance for. If not specified, returns all assets with balance higher than 0.

The request was successful.

Response Headers

bitvavo-ratelimit-remaining

The number of remaining weight points before it resets at bitvavo-ratelimit-resetat.

bitvavo-ratelimit-resetat

The time when bitvavo-ratelimit-remaining resets to bitvavo-ratelimit-limit.

bitvavo-ratelimit-limit

The number of available weight points in one minute.

Schema

balances object[]required

The balances array with an object per subaccount.

Array [

symbolstring

The asset for which to return the balance (e.g., EUR, BTC, ETH).

availablestring

The amount available for transfer or ordering.

inOrderstring

The amount reserved by open orders.

]

{
  "balances": [
    {
      "symbol": "string",
      "available": "string",
      "inOrder": "string"
    }
  ]
}