Path Parameters
- xpub_or_addressstringREQUIRED
An address, an extended public key, or an output descriptor. Supported descriptor form:
pkh(...). 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:
pkh([73c5da0a/44'/3'/0']xpub...) - multipath selectors:
pkh(xpub.../<0;1>/*) - explicit branch paths:
pkh(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 - pkh(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/44'/3'/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": "28d80bd00d1eb86f1b54c19d7134463e537af9b307bf1a66f68426614418cb84",4"vout": 0,5"value": "1000836479028",6"height": 6241373,7"confirmations": 3,8"coinbase": true9},10{11"txid": "295166716bd4f8905e0da1c83d161aa2404b29c719151a6ad5553a0d7f809b05",12"vout": 0,13"value": "1000162555370",14"height": 6241366,15"confirmations": 10,16"coinbase": true17},18{19"txid": "2663c615935493ccb6448a248a93c108d7cdbea3923371e63332e6e611d7c99f",20"vout": 0,21"value": "1000124300000",22"height": 6241364,23"confirmations": 12,24"coinbase": true25}26]
1[2{3"txid": "28d80bd00d1eb86f1b54c19d7134463e537af9b307bf1a66f68426614418cb84",4"vout": 0,5"value": "1000836479028",6"height": 6241373,7"confirmations": 3,8"coinbase": true9},10{11"txid": "295166716bd4f8905e0da1c83d161aa2404b29c719151a6ad5553a0d7f809b05",12"vout": 0,13"value": "1000162555370",14"height": 6241366,15"confirmations": 10,16"coinbase": true17},18{19"txid": "2663c615935493ccb6448a248a93c108d7cdbea3923371e63332e6e611d7c99f",20"vout": 0,21"value": "1000124300000",22"height": 6241364,23"confirmations": 12,24"coinbase": true25}26]