---
title: "QueryBalances"
method: POST
path: "/v2/vaults/{vault_id}:queryBalances"
tags: ["Balances"]
---

# QueryBalances

`POST /v2/vaults/{vault_id}:queryBalances`

Retrieve a list of all asset balances in all wallets in a vault.

## Path parameters

- `vault_id` string, required

## Request body

- BalancesQueryBalancesBody
  - `filter` string — 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()`)
  - `pageSize` integer — The maximum number of items to return. The service may return fewer than this value.
  - `pageToken` string — A page token, received from the previous list call as `nextPageToken`.
  - `includeReferencedResources` boolean — Include referenced resources in the response.

## Response `200`

A successful response.

- V2QueryBalancesResponse
  - `balances` V2Balance[] — The balances returned.
    - `asset` string — The resource name of the asset. Format: `assets/{asset_id}`
    - `value` string — The amount of the asset, in decimal form with precision included.
    - `rawValue` string — The raw amount of the asset that this balance contains. Specified in the smallest unit of the Asset.
    - `frozenValue` string
  - `nextPageToken` string — A token, which can be sent as `pageToken` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  - `totalSize` integer — Total number of items in the response, regardless of pagination.
  - `referencedResources` object — A mapping of the referenced resources in the message. The key is the resource name and the value is the corresponding resource.

---

[API](https://skmtc.dev/utila/apis/utila-api.md) · [All operations](https://skmtc.dev/utila/apis/utila-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/utila/utila-api/revisions/b4f35b3a1e96/schema)