gettxoutsetinfo

Note this call may take some time if you are not using coinstatsindex.

Argument #1-hash_type

Type: string, Optional
Default="hash_serialized_3"

Description: Which UTXO set hash should be calculated. Options: 'hash_serialized_3' (the legacy algorithm), 'muhash', 'none'.

Argument #2-hash_or_height

Type: string or numeric, Optional
Default=the current best block

Description: The block hash or height of the target height (only available with coinstatsindex).

Argument #3-use_index

Type: boolean, Optional
Default=true

Description: Use coinstatsindex, if available.

Result

  {                                     (json object)
    "height" : n,                       (numeric) The block height (index) of the returned statistics
    "bestblock" : "hex",                (string) The hash of the block at which these statistics are calculated
    "txouts" : n,                       (numeric) The number of unspent transaction outputs
    "bogosize" : n,                     (numeric) Database-independent, meaningless metric indicating the UTXO set size
    "hash_serialized_3" : "hex",        (string, optional) The serialized hash (only present if 'hash_serialized_3' hash_type is chosen)
    "muhash" : "hex",                   (string, optional) The serialized hash (only present if 'muhash' hash_type is chosen)
    "transactions" : n,                 (numeric, optional) The number of transactions with unspent outputs (not available when coinstatsindex is used)
    "disk_size" : n,                    (numeric, optional) The estimated size of the chainstate on disk (not available when coinstatsindex is used)
    "total_amount" : n,                 (numeric) The total amount of coins in the UTXO set
    "total_unspendable_amount" : n,     (numeric, optional) The total amount of coins permanently excluded from the UTXO set (only available if coinstatsindex is used)
    "block_info" : {                    (json object, optional) Info on amounts in the block at this block height (only available if coinstatsindex is used)
      "prevout_spent" : n,              (numeric) Total amount of all prevouts spent in this block
      "coinbase" : n,                   (numeric) Coinbase subsidy amount of this block
      "new_outputs_ex_coinbase" : n,    (numeric) Total amount of new outputs created by this block
      "unspendable" : n,                (numeric) Total amount of unspendable outputs created in this block
      "unspendables" : {                (json object) Detailed view of the unspendable categories
        "genesis_block" : n,            (numeric) The unspendable amount of the Genesis block subsidy
        "bip30" : n,                    (numeric) Transactions overridden by duplicates (no longer possible with BIP30)
        "scripts" : n,                  (numeric) Amounts sent to scripts that are unspendable (for example OP_RETURN outputs)
        "unclaimed_rewards" : n         (numeric) Fee rewards that miners did not claim in their coinbase transaction
      }
    }
  }