bitcoind.app
CommandsGuidesContact ↗
Home/Blockchain/scantxoutset
Blockchain

scantxoutset

Scan the UTXO set for entries that match certain output descriptors.

Parameters

actionstringREQUIRED
"start", "abort", or "status"
scanobjectsarrayoptional
Array of scan descriptors

Returns

objectScan results with matched UTXOs

Code Examples

curl --user myuser --data-binary '{"jsonrpc":"1.0","id":"1","method":"scantxoutset","params":["start",["addr(bc1q...)"]]}' -H 'content-type:text/plain;' http://127.0.0.1:8332/

Example Response

{
  "success": true,
  "txouts": 94523182,
  "height": 840000,
  "bestblock": "00000000000000...",
  "unspents": [
    {
      "txid": "a1075db55d...",
      "vout": 0,
      "scriptPubKey": "0014...",
      "desc": "wpkh(...)#...",
      "amount": 0.50000000,
      "height": 839000
    }
  ],
  "total_amount": 0.50000000
}
← Previous
scanblocks
Next →
addpeeraddress

More Blockchain Commands

getbestblockhashgetblockgetblockchaininfogetblockcountgetblockfiltergetblockhash

bitcoind.app — Bitcoin Core RPC Reference

GuidesContact ↗