---
title: "QueryWalletUTXOs"
method: POST
path: "/v2/vaults/{vault_id}/wallets/{wallet_id}:queryUTXOs"
tags: ["Balances"]
---

# QueryWalletUTXOs

`POST /v2/vaults/{vault_id}/wallets/{wallet_id}:queryUTXOs`

Retrieve a list of all UTXOs in a wallet.

## Path parameters

- `vault_id` string, required
- `wallet_id` string, required

## Request body

- BalancesQueryWalletUTXOsBody
  - `network` string, required — The resource name of the network whose UTXOs are to be listed. Format: `networks/{network_id}`.
  - `filter` string — Filter results using EBNF syntax. Supported fields: * `txHash` (example: `txHash = "60887d40d469af2b52cf7dc35e6c33241610aa22ca0c8d0d5e4d9027e91c2946"`) * `address` (example: `address = "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4"`) * `state` (example: `state = AVAILABLE OR state = FROZEN`)
  - `orderBy` string — SQL-like ordering specifications. Supports the fields `create_time`, `value`.
  - `pageSize` integer — The maximum number of items to return. The service may return fewer than this value. If unspecified, at most 50 will be returned. The maximum value is 100; values above 100 will be coerced to 100.
  - `pageToken` string — A page token, received from the previous list call as `nextPageToken`. Provide this to retrieve the subsequent page. When paginating, all other parameters must match the call that provided the page token.
  - `skip` integer — How many results to skip. Note: may be used alongside token-based pagination (see `pageToken`), although this won't be needed for most use cases.
  - `includeReferencedResources` boolean — Include referenced resources in the response.

## Response `200`

A successful response.

- V2QueryWalletUTXOsResponse
  - `utxos` Apiv2UTXO[] — The UTXOs returned.
    - `network` string — The resource name of the network of the UTXO. Format: `networks/{network_id}`.
    - `txHash` string — The hash of the transaction that created this UTXO.
    - `vout` integer — The output index in the transaction that created this UTXO.
    - `walletAddress` string — The resource name of the wallet address that owns this UTXO. Format: `vaults/{vault_id}/wallets/{wallet_id}/addresses/{address_id}`
    - `scriptType` string — The script type of the UTXO.
    - `state` 'AVAILABLE' | 'LOCKED' | 'FROZEN' — - AVAILABLE: The UTXO is available for spending. - LOCKED: The UTXO is locked by a pending transaction. - FROZEN: The UTXO is frozen due to compliance reasons and cannot be spent.
    - `confirmations` integer — The number of confirmations for this UTXO.
    - `value` string — The amount of the UTXO, in decimal form with precision included.
    - `convertedValue` V2ConvertedValue — A message representing a converted value.
      - `amount` string — The amount in USD.
      - `currencyCode` string — The currency code of the amount. Always USD.
    - `createTime` string, date-time — First time the UTXO was seen by Utila.
  - `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. This field is only populated if the `includeReferencedResources` field is set to `true`.

---

[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)