Balances

QueryWalletBalances

Changed on Nov 3, 2026

Retrieve a list of all asset balances in a wallet. Can be used also to retrieve assets across all wallets as per AIP-159 by using '-' (the hyphen or dash character) as a wildcard character instead of wallet ID in the parent.

post/v2/vaults/{vault_id}/wallets/{wallet_id}:queryBalances

Request

Base URL
https://api.utila.io
Auth
HTTP bearer
TypeScript
https://skmtc.dev/utila/apis/utila-api/docs/v2/vaults/:vault_id/wallets/:wallet_id:queryBalances/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

vault_idstring required

wallet_idstring required

Request body

filterstring

Filter results using EBNF syntax.

Supported functions:

asset(asset_name) (example: asset("assets/native.ethereum-mainnet"))
network(network_name) (example: network("networks/ethereum-mainnet"))
wallet_external() (example: wallet_external())

pageSizeinteger

The maximum number of items to return. The service may return fewer than this value.

pageTokenstring

A page token, received from the previous list call as nextPageToken.

includeReferencedResourcesboolean

Include referenced resources in the response.

Response

A successful response.

nextPageTokenstring

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted, there are no subsequent pages.

totalSizeinteger

Total number of items in the response, regardless of pagination.

referencedResourcesobject

A mapping of the referenced resources in the message. The key is the resource name and the value is the corresponding resource.

This field is only populated if the includeReferencedResources field is set to true.

Example response

{
  "walletBalances": [
    {
      "asset": "assets/native.ethereum-mainnet",
      "wallet": "vaults/1b25635a5b3f/wallets/203809def2",
      "value": "1.3",
      "rawValue": "13000000",
      "frozenValue": "0.3"
    }
  ]
}

Changes

Nov 3, 2026c4a910d79740 Revision changes
- breaking
  the response property /////// became optional for the status
- warning
  removed the optional property ////////////// from the response with the status
- warning
  removed the optional property /////// from the response with the status
- warning
  added the new ERC7984 enum value to the //////////////// response property for the response status
- warning
  added the new EVM_ZAMA_CONFIDENTIAL_TOKEN_ACTIVATION enum value to the /////////// response property for the response status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property //////////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property /////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property ///////////////////// to the response with the status
- info
  added the optional property /////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property //////////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property //////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////////// to the response with the status
- info
  added the optional property ////////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property // to the response with the status
- info
  added to the //////////// response property allOf list for the response status
- info
  added to the /////// response property allOf list for the response status
- info
  removed from the /////// response property allOf list for the response status
- info
  removed from the //////////// response property allOf list for the response status

Operation history