getchaintxstats

Back to blockchain

Summary

Compute statistics about the total number and rate of transactions in the chain.

Description

Compute statistics about the total number and rate of transactions in the chain.

Arguments

  • nblocks (NUM): Size of the window in number of blocks
  • blockhash (STR_HEX): The hash of the block that ends the window.

Results

  • value (OBJ): No description.
  • time (NUM_TIME): The timestamp for the final block in the window, expressed in UNIX epoch time
  • txcount (NUM, optional): The total number of transactions in the chain up to that point, if known. It may be unknown when using assumeutxo.
  • window_final_block_hash (STR_HEX): The hash of the final block in the window
  • window_final_block_height (NUM): The height of the final block in the window.
  • window_block_count (NUM): Size of the window in number of blocks
  • window_interval (NUM, optional): The elapsed time in the window in seconds. Only returned if "window_block_count" is > 0
  • window_tx_count (NUM, optional): The number of transactions in the window. Only returned if "window_block_count" is > 0 and if txcount exists for the start and end of the window.
  • txrate (NUM, optional): The average rate of transactions per second in the window. Only returned if "window_interval" is > 0 and if window_tx_count exists.

Examples

qbit-cli getchaintxstats

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