Skip to main content

bb_getUTXOs RPC Method - Blockbook

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

Updated on
Sep 02, 2026
Please note that this RPC method requires the Litecoin 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 forms: pkh(...), wpkh(...), sh(wpkh(...)), and tr(...). 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: 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.

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 Litecoin-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 satoshis (litoshis) 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/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.

coinbase
boolean

Whether the UTXO is a Coinbase transaction. Coinbase UTXOs have this field set to true, however, due to performance reasons, it will return only up to the minimum Coinbase confirmations limit (100). After this limit, UTXOs are not detected as Coinbase.

Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free