---
title: "Get UTXOs for an address, XPUB, or descriptor."
method: GET
path: "/api/v2/utxo/{descriptor}"
tags: ["Accounts"]
---

# Get UTXOs for an address, XPUB, or descriptor.

`GET /api/v2/utxo/{descriptor}`

Returns unspent outputs for an address, XPUB, or descriptor on
Bitcoin-type coins. By default both confirmed and unconfirmed UTXOs are
returned; confirmed=true filters out unconfirmed entries. Results are
sorted by block height with newest entries first.

Unconfirmed UTXOs omit height, have confirmations set to 0, and can
include lockTime. XPUB and descriptor UTXOs also include address and
derivation path when available. Coinbase UTXOs include coinbase=true
only up to the coinbase confirmation limit, currently 100 blocks.

Load estimate: Variable; address lookups are usually medium, while
XPUB/descriptor lookups grow with gap, derived addresses, and UTXO
count.

## Path parameters

- `descriptor` string, required

## Query parameters

- `confirmed` boolean
- `gap` integer

## Response `200`

UTXO list.

- Utxo[]
  - `txid` string, required
  - `vout` integer, required
  - `value` string — Integer amount in the lowest chain denomination, encoded as a string.
  - `height` integer
  - `confirmations` integer, required
  - `address` string
  - `path` string
  - `lockTime` integer
  - `coinbase` boolean

## Other responses

- `default` — Public API error. Public validation errors are HTTP 400; internal errors are HTTP 500.

---

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