---
title: "Get unspent UTXOs for an address"
method: GET
path: "/v4/data/utxos"
tags: ["Wallet API"]
---

# Get unspent UTXOs for an address

`GET /v4/data/utxos`

## Request

- Base URL: `https://api.tatum.io`
- URL: `https://api.tatum.io/v4/data/utxos`
- Auth: API key in header `x-api-key`

/v4/data/utxos

**100 credits per API call**

\> 📘 \*\*Note for v3 API users:\*\* > > As part of our documentation consolidation, we removed the dedicated page for GET /v3/data/utxos. Users can refer to GET /v4/data/utxos for the latest documentation, as both endpoints function the same—simply replace v4 with v3 in the API URL if using the v3 version.

Get unspent UTXOs for a specific address up to a specific total amount. If you want to prepare a transaction on UTXO-based chains like Bitcoin, you need to enter unspent UTXOs to be able to perform a transaction. By providing \`\`\`totalValue\`\`\` as a total, our API will return a list of UTXOs that will be enough to cover the transaction.

Our API lets you get the unpenst UTXOs for a specific address on:

*   Bitcoin - bitcoin / bitcoin-testnet
*   Litecoin - litecoin / litecoin-testnet
*   Dogecoin - doge / doge-testnet
*   Cardano - cardano / cardano-preprod

To get started:

*   Provide a chain and address you want to list unspent UTXOs for. If available, our API will return information about the unspent UTXOs for a specific address.
*   Note: Bitcoin mainnet, Bitcoin testnet, Litecoin mainnet, Litecoin testnet, Dogecoin mainnet, Dogecoin testnet are now supported for any amount of utxo's on address with our latest update. This functionality will be extended to other chains soon.

## Query parameters

- `chain` 'bitcoin' | 'bitcoin-mainnet' | 'bitcoin-testnet' | 'litecoin' | 'litecoin-mainnet' | 'litecoin-testnet' | 'doge' | 'doge-mainnet' | 'doge-testnet' | 'cardano' | 'cardano-mainnet' | 'cardano-preprod', required: The blockchain to work with.
- `address` string, required
- `totalValue` number, required

## Response `200`

OK

- Utxo[]: Information about specific collection or token (not all fields are available for every token, e.g. some multitokens do not have name and symbol).
  - `chain` 'bitcoin' | 'bitcoin-mainnet' | 'bitcoin-testnet' | 'litecoin' | 'litecoin-mainnet' | 'litecoin-testnet' | 'doge' | 'doge-mainnet' | 'doge-testnet' | 'cardano' | 'cardano-mainnet' | 'cardano-preprod', required: The blockchain to work with.
  - `address` string, required: Address of the UTXO
  - `txHash` string, required: Hash of the transaction this UTXO is present in
  - `index` number, required: Index of the UTXO in the transaction
  - `value` number, required: Value of the UTXO, in BTC, LTC or DOGE.
  - `valueAsString` string, required: String representation of the value of the UTXO, in BTC, LTC or DOGE.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

## Changes

- **2026-11-03** `1a87afa0f639`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tatum/apis/blockchain-data/changes/v4/data/utxos/get.md)

---

[API](https://skmtc.dev/tatum/apis/blockchain-data.md) - [All operations](https://skmtc.dev/tatum/apis/blockchain-data/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/blockchain-data/revisions/1a87afa0f639?raw)