Skip to main content

bb_getUTXOs RPC Method - Blockbook

Get all of the unspent transaction outputs for a given Bitcoin Cash address, extended public key, or output descriptor.

Updated on
Sep 02, 2026
Please note that this RPC method requires the BCH Blockbook JSON-RPC enabled on your Quicknode endpoint.

Parameters

xpub_or_descriptor
string
REQUIRED

An address, an extended public key, or an output descriptor wrapping an extended public key. Supported descriptor form: pkh(...). Extended public keys must be account-level keys, not master keys.

Descriptors containing a / are not supported and return an error.

This includes:

  • key origin prefixes: pkh([73c5da0a/44'/145'/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.

object
object

The options object with the following fields:

confirmed
boolean

Whether or not to exclude unconfirmed transactions.

gap
integer

The gap limit used when deriving addresses from an extended public key (xpub). Defaults to 20.

Returns

When querying by xpub or descriptor, each UTXO includes address and path, which identify the derivation branch and index it came from. Both are omitted when querying a single address, since the address is already known.

tx
array

An array of unspent transaction outputs for an address or xpub, applicable only for Bitcoin-type coins. By default, the list contains both confirmed and unconfirmed transactions.

txid
string

The transaction id

vout
integer

The 4-byte index indicating the position of a transaction output

value
string

The value in satoshis of the output

confirmations
integer

The number of block confirmations since the output was created

height
integer

The block height at which the transaction output was created

address
string

The address this UTXO belongs to. Returned only for xpub and descriptor queries; omitted for single-address queries.

path
string

BIP32 derivation path of the address, e.g. m/44'/145'/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.

Request
Response
1
{
2
"id": 1,
3
"result": [
4
{
5
"txid": "3e5a53348fcac5459d82eedef9ce8b59694a23fa8cc7f00226ad06335f608742",
6
"vout": 2,
7
"value": "9897005",
8
"height": 916715,
9
"confirmations": 1
10
},
11
{
12
"txid": "7d51c4e81679c3eced85fd7a3f6ab79cfffbc77b63d1c70759dbb94b000110e0",
13
"vout": 2,
14
"value": "1951",
15
"height": 916286,
16
"confirmations": 430
17
},
18
{
19
"txid": "0406af511e0b5e3cbb4c8ccbbe89b7bf48489bbf5d77823d9ee184f2a9516e42",
20
"vout": 2,
21
"value": "1774",
22
"height": 916204,
23
"confirmations": 512
24
},
25
{
26
"txid": "cd4a526f972b4942c68de2c57d9efdf11db8653cacd2baff9c3f34b902370c60",
27
"vout": 2,
28
"value": "1642",
29
"height": 916067,
30
"confirmations": 649
31
},
32
{
33
"txid": "842eb4b3146be5bd4f0c8b172dbac6e2a68e1217f20c040f97967ea78f0969af",
34
"vout": 2,
35
"value": "1539",
36
"height": 901527,
37
"confirmations": 15189
38
}
39
],
40
"jsonrpc": "2.0"
41
}
1
{
2
"id": 1,
3
"result": [
4
{
5
"txid": "3e5a53348fcac5459d82eedef9ce8b59694a23fa8cc7f00226ad06335f608742",
6
"vout": 2,
7
"value": "9897005",
8
"height": 916715,
9
"confirmations": 1
10
},
11
{
12
"txid": "7d51c4e81679c3eced85fd7a3f6ab79cfffbc77b63d1c70759dbb94b000110e0",
13
"vout": 2,
14
"value": "1951",
15
"height": 916286,
16
"confirmations": 430
17
},
18
{
19
"txid": "0406af511e0b5e3cbb4c8ccbbe89b7bf48489bbf5d77823d9ee184f2a9516e42",
20
"vout": 2,
21
"value": "1774",
22
"height": 916204,
23
"confirmations": 512
24
},
25
{
26
"txid": "cd4a526f972b4942c68de2c57d9efdf11db8653cacd2baff9c3f34b902370c60",
27
"vout": 2,
28
"value": "1642",
29
"height": 916067,
30
"confirmations": 649
31
},
32
{
33
"txid": "842eb4b3146be5bd4f0c8b172dbac6e2a68e1217f20c040f97967ea78f0969af",
34
"vout": 2,
35
"value": "1539",
36
"height": 901527,
37
"confirmations": 15189
38
}
39
],
40
"jsonrpc": "2.0"
41
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free