---
title: "Get UTXOs for an address"
method: GET
path: "/v1/cryptos/{cryptoCode}/addresses/{address}/utxos"
tags: ["Addresses"]
---

# Get UTXOs for an address

`GET /v1/cryptos/{cryptoCode}/addresses/{address}/utxos`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/cryptos/{cryptoCode}/addresses/{address}/utxos`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/btcpayserver/apis/nbxplorer-api/docs/v1/cryptos/:cryptoCode/addresses/:address/utxos/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves UTXOs associated with a tracked standalone address.

## Path parameters

- `cryptoCode` string, required
- `address` string, required

## Response `200`

UTXOs retrieved successfully.

- UTXOChanges
  - `trackedSource` string: The tracked source identifier, which can be a group or a derivation scheme.
  - `currentHeight` integer: The current height of the blockchain.
  - `unconfirmed` UTXOChange: The list of unconfirmed UTXOs and of spent confirmed UTXOs
    - `utxOs` UTXO[]
      - `feature` string: Specifies the type of address from which this UTXO originated. Possible values are: - `Deposit`: An address from the external chain (`0/x`). - `Change`: An address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
      - `outpoint` string: The unique identifier of the UTXO, consisting of the transaction ID and the output index, formatted as `{transactionHash}-{outputIndex}`.
      - `index` integer: The index of the output in the transaction. Indicates which output of the transaction this UTXO corresponds to.
      - `transactionHash` string: The transaction ID (hash) of the transaction that created this UTXO.
      - `scriptPubKey` string: The scriptPubKey of the UTXO in hexadecimal format. This script specifies the conditions under which the UTXO can be spent.
      - `address` string: The Bitcoin address corresponding to the scriptPubKey.
      - `value` integer: The amount of the UTXO in satoshis.
      - `keyPath` string: The derivation path used to derive the address for this UTXO from the master public key. For example, `0/0`. (Only for standard derivation schemes)
      - `keyIndex` string: This index of this key in the `feature`.
      - `timestamp` integer: The UNIX timestamp indicating when the UTXO was first seen by NBXplorer.
      - `confirmations` integer: The number of confirmations of the transaction containing this UTXO. A value of `0` means the transaction is unconfirmed.
    - `spentOutpoints` string[]: List of confirmed outpoints that were spent. (Only available for the unconfirmed UTXOChange)
  - `confirmed` UTXOChange: The list of unconfirmed UTXOs and of spent confirmed UTXOs
    - `utxOs` UTXO[]
      - `feature` string: Specifies the type of address from which this UTXO originated. Possible values are: - `Deposit`: An address from the external chain (`0/x`). - `Change`: An address from the internal chain (`1/x`). - `Direct`: An address from the direct chain (`x`). - `Custom`: An address using a custom key path template.
      - `outpoint` string: The unique identifier of the UTXO, consisting of the transaction ID and the output index, formatted as `{transactionHash}-{outputIndex}`.
      - `index` integer: The index of the output in the transaction. Indicates which output of the transaction this UTXO corresponds to.
      - `transactionHash` string: The transaction ID (hash) of the transaction that created this UTXO.
      - `scriptPubKey` string: The scriptPubKey of the UTXO in hexadecimal format. This script specifies the conditions under which the UTXO can be spent.
      - `address` string: The Bitcoin address corresponding to the scriptPubKey.
      - `value` integer: The amount of the UTXO in satoshis.
      - `keyPath` string: The derivation path used to derive the address for this UTXO from the master public key. For example, `0/0`. (Only for standard derivation schemes)
      - `keyIndex` string: This index of this key in the `feature`.
      - `timestamp` integer: The UNIX timestamp indicating when the UTXO was first seen by NBXplorer.
      - `confirmations` integer: The number of confirmations of the transaction containing this UTXO. A value of `0` means the transaction is unconfirmed.
    - `spentOutpoints` string[]: List of confirmed outpoints that were spent. (Only available for the unconfirmed UTXOChange)
  - `spentUnconfirmed` string[]: List of still unconfirmed outpoints that were spent. For a transaction chain `A->B->C` where `B` spends `A` and `C` spends `B`, outpoints `A` and `B` will appear here since they remain unconfirmed until the entire chain confirms.

## Changes

- **2026-09-29** `52231f42c765`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/changes/v1/cryptos/:cryptoCode/addresses/:address/utxos/get.md)

---

[API](https://skmtc.dev/btcpayserver/apis/nbxplorer-api.md) - [All operations](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/revisions/52231f42c765?raw)