Path Parameters
- xpub_or_addressstringREQUIRED
An address, an extended public key, or an output descriptor. Supported descriptor forms:
pkh(...),wpkh(...),sh(wpkh(...)), andtr(...). Must be an account-level key, not a master key. URL-encode the descriptor when placing it in the REST path.
Descriptors containing a / are not supported and return an error.
This includes:
- key origin prefixes:
tr([73c5da0a/86'/2'/0']xpub...) - multipath selectors:
tr(xpub.../<0;1>/*) - explicit branch paths:
tr(xpub.../0/*)
Percent-encoding the slash does not help. Note the origin prefix cannot be shortened either, since it contains slashes of its own.
Use the bare form instead - tr(xpub...) - which is fully supported. The branch selector is unnecessary: Blockbook automatically scans both the receive (0) and change (1) branches for the account.
Query Parameters
- confirmedboolean
When set to true, only returns confirmed UTXOs.
- gapinteger
The gap limit used when deriving addresses from an extended public key (xpub). Defaults to 20.
Returns
- txidstring
Transaction ID of the UTXO
- voutinteger
Output index in the transaction
- valuestring
UTXO value in satoshis
- heightinteger
Block height where the UTXO was created
- confirmationsinteger
Number of confirmations
- addressstring
The address this UTXO belongs to. Returned only for xpub and descriptor queries; omitted for single-address queries.
- pathstring
BIP32 derivation path of the address, e.g.
m/86'/2'/0'/0/0. The last two segments are the branch (0 = receive, 1 = change) and the address index. Returned only for xpub and descriptor queries; omitted for single-address queries.
1[2{3"txid": "9254198db863fb346fc341ba7de48812d1edab2eb1c6f2b3a2690ff3e40a4eba",4"vout": 0,5"value": "625085786",6"height": 3121799,7"confirmations": 5,8"coinbase": true9},10{11"txid": "0a2c1dc78bafd04995995f3b5937b9f6f6dc4e7b45816cd571fe0f4c2306e30f",12"vout": 0,13"value": "625198231",14"height": 3121797,15"confirmations": 7,16"coinbase": true17}18]
1[2{3"txid": "9254198db863fb346fc341ba7de48812d1edab2eb1c6f2b3a2690ff3e40a4eba",4"vout": 0,5"value": "625085786",6"height": 3121799,7"confirmations": 5,8"coinbase": true9},10{11"txid": "0a2c1dc78bafd04995995f3b5937b9f6f6dc4e7b45816cd571fe0f4c2306e30f",12"vout": 0,13"value": "625198231",14"height": 3121797,15"confirmations": 7,16"coinbase": true17}18]