getchaintxstats

blockchain expensive since 0.15.0

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

↑ shares the docs page. Use Share this query below for a link with your current arg values.

Expensive RPC. CPU- or scan-heavy. Cached and rate-limited per IP to keep the node healthy. We surface the most recent snapshot below instead of running this on demand.

Latest snapshot captured 2026-05-12T12:15:52Z UTC · args: []

{
  "time": 1778587969,
  "txcount": 1355763624,
  "txrate": 6.818477816272853,
  "window_block_count": 4320,
  "window_final_block_hash": "00000000000000000000cd82663a4f607bb1e8a69d0ace429e8717a6f8172a9d",
  "window_final_block_height": 949068,
  "window_interval": 2584169,
  "window_tx_count": 17620099
}

Call from your own code

Replace $BITCOIN_RPC_USER / $BITCOIN_RPC_PASSWORD with credentials from your bitcoind's bitcoin.conf, and replace localhost:8332 with your node's RPC address. You can't run this RPC against our node, but you can run it against your own bitcoind.

Help

getchaintxstats ( nblocks "blockhash" )

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

Arguments:
1. nblocks      (numeric, optional, default=one month) Size of the window in number of blocks
2. blockhash    (string, optional, default=chain tip) The hash of the block that ends the window.

Result:
{                                       (json object)
  "time" : xxx,                         (numeric) The timestamp for the final block in the window, expressed in UNIX epoch time
  "txcount" : n,                        (numeric) The total number of transactions in the chain up to that point
  "window_final_block_hash" : "hex",    (string) The hash of the final block in the window
  "window_final_block_height" : n,      (numeric) The height of the final block in the window.
  "window_block_count" : n,             (numeric) Size of the window in number of blocks
  "window_tx_count" : n,                (numeric, optional) The number of transactions in the window. Only returned if "window_block_count" is > 0
  "window_interval" : n,                (numeric, optional) The elapsed time in the window in seconds. Only returned if "window_block_count" is > 0
  "txrate" : n                          (numeric, optional) The average rate of transactions per second in the window. Only returned if "window_interval" is > 0
}

Examples:
> bitcoin-cli getchaintxstats 
> curl --user myusername --data-binary '{"jsonrpc": "1.0", "id": "curltest", "method": "getchaintxstats", "params": [2016]}' -H 'content-type: text/plain;' http://127.0.0.1:8332/

← back to all RPCs