Account

Get All Account Balances

Get an array of all AccountBalances for all sub-accounts of an AccountIdentifier and the BlockIdentifier at which the balance lookup was performed. This endpoint returns balances for the main account and all associated sub-accounts in a single request, eliminating the need to make multiple individual /account/balance calls.

The BlockIdentifier must always be returned because some consumers of account balance data need to know specifically at which block the balance was calculated to compare balances they compute from operations with the balance returned by the node.

This endpoint automatically returns all available sub-account types for the given account, including the main account balance and all sub-accounts (e.g., delegated, unbonding, rewards, etc.).

It is also possible to perform a historical balance lookup (if the server supports it) by passing in an optional BlockIdentifier.

This endpoint provides better performance and consistency compared to making multiple individual /account/balance requests, as all balances are guaranteed to be from the same block context.

post/account/all-balances

Request body

network_identifierNetworkIdentifier required— unresolved $ref
account_identifierAccountIdentifier required— unresolved $ref
block_identifierPartialBlockIdentifier — unresolved $ref
currenciesCurrency[] — unresolved $ref

In some cases, the caller may not want to retrieve all available balances for an AccountIdentifier. If the currencies field is populated, only balances for the specified currencies will be returned. If not populated, all available balances will be returned.

Response

Expected response to a valid request

block_identifierBlockIdentifier required— unresolved $ref

Changes