Skip to main content

bb_getutxos RPC Method

Get all of the unspent transaction outputs for a given Bitcoin address or xpub.

Updated on
Oct 4, 2023

bb_getutxos RPC Method

Please note that this RPC method requires the Blockbook RPC add-on enabled on your QuickNode endpoint.

Parameters

xpub_or_descriptor
string
REQUIRED
Typically a Bitcoin address but can also be xpub.
object
array
The options object with the following fields:
confirmed
boolean
Whether or not to exclude unconfirmed transactions.

Returns

tx
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
The transaction id
vout
The 4-byte index indicating the position of a transaction output
value
The value in satoshis of the output
confirmations
The number of block confirmations since the output was created
height
The block height at which the transaction output was created
coinbase
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
1
curl https://docs-demo.btc.quiknode.pro/ \
2
-X POST \
3
-H "Content-Type: application/json" \
4
--data '{"method": "bb_getutxos", "params": ["bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0", {"confirmed": true}]}'
5
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free