UTXO - Get balance

Modified on Tue, 28 Feb 2023 at 09:55 AM

Getting the address balance of an UTXO-based asset is a challenge.

Currently, scantxoutset is the only available method via RPC node call to achieve this goal. See returned param total_amount.

Where:

scantxoutset start "[\"addr(tb1qfg7456fh3u4wkff42zpznhjs3w5hcn469p3ymy)\"]"

//returns:

{                                (json object)
  "success" : true|false,        (boolean) Whether the scan was completed
  "txouts" : n,                  (numeric) The number of unspent transaction outputs scanned
  "height" : n,                  (numeric) The current block height (index)
  "bestblock" : "hex",           (string) The hash of the block at the tip of the chain
  "unspents" : [                 (json array)
    {                            (json object)
      "txid" : "hex",            (string) The transaction id
      "vout" : n,                (numeric) The vout value
      "scriptPubKey" : "hex",    (string) The script key
      "desc" : "str",            (string) A specialized descriptor for the matched scriptPubKey
      "amount" : n,              (numeric) The total amount in BTC of the unspent output
      "height" : n               (numeric) Height of the unspent transaction output
    },
    ...
  ],
  "total_amount" : n             (numeric) The total amount of all found unspent outputs in BTC
}