gettxoutsetinfo

Back to blockchain

Summary

Returns statistics about the unspent transaction output set.

Description

Returns statistics about the unspent transaction output set. Note this call may take some time if you are not using coinstatsindex.

Arguments

  • hash_type (STR): Which UTXO set hash should be calculated. Options: 'hash_serialized_3' (the legacy algorithm), 'muhash', 'none'.
  • hash_or_height (NUM): The block hash or height of the target height (only available with coinstatsindex).
  • use_index (BOOL): Use coinstatsindex, if available.

Results

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

Examples

qbit-cli gettxoutsetinfo

qbit-cli gettxoutsetinfo "none"

qbit-cli gettxoutsetinfo "none" 1000

qbit-cli gettxoutsetinfo "none" '"00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"'

qbit-cli -named gettxoutsetinfo hash_type='muhash' use_index='false'

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "gettxoutsetinfo", "params": []}' -H 'content-type: application/json' http://127.0.0.1:8352/

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "gettxoutsetinfo", "params": ["none"]}' -H 'content-type: application/json' http://127.0.0.1:8352/

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "gettxoutsetinfo", "params": ["none", 1000]}' -H 'content-type: application/json' http://127.0.0.1:8352/

curl --user myusername --data-binary '{"jsonrpc": "2.0", "id": "curltest", "method": "gettxoutsetinfo", "params": ["none", "00000000c937983704a73af28acdec37b049d214adbda81d7e2a3dd146f6ed09"]}' -H 'content-type: application/json' http://127.0.0.1:8352/