Skip to main content

bb_getUTXOs RPC Method - Blockbook

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

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

Parameters

address_or_xpub
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'/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.

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.

result
array

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

txid
string

The transaction id

vout
integer

The output index indicating the position of a transaction output

value
string

The value in the smallest unit of DOGE (koinu) of the output

height
integer

The block height at which the transaction output was created

confirmations
integer

The number of block confirmations since the 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'/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.

coinbase
boolean

Whether the UTXO is from a Coinbase transaction (mining reward). This flag is typically present for UTXOs with under 100 confirmations that come from mining.

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": []
5
}
1
{
2
"jsonrpc": "2.0",
3
"id": 1,
4
"result": []
5
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free