getchaintxstats

getchaintxstats reports how many transactions the Bitcoin chain has ever recorded and how fast they have been arriving lately. It returns the cumulative txcount up to a chosen block plus window figures — window_tx_count, window_interval, and txrate (transactions per second) — measured over a span you control with nblocks. Since Bitcoin settles BTC roughly every ten minutes, this is the cleanest single call for throughput analytics without summing blocks yourself. Send it to https://bitcoin.therpc.io/YOUR_API_KEY, optionally passing a window size and a final block hash.

Use cases

• Compute the recent network transaction rate from txrate over a chosen block window.
• Report the total on-chain transaction count up to a given block with txcount.
• Chart Bitcoin throughput trends over time for an analytics or status page.

Parameters

Response

Example request

1curl https://bitcoin.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "1.0",
6  "id": "therpc",
7  "method": "getchaintxstats",
8  "params": [
9    0,
10    "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f"
11  ]
12}'

Errors & troubleshooting

Common pitfalls

• txrate is transactions per second across the window, so multiply it by window_interval (seconds) to recover an actual transaction count.
• A very small nblocks window makes the rate noisy because Bitcoin's ~10-minute block timing varies — widen the window for a stable figure.

Supported networks

• Mainnet
• Testnet

See also

• getblockstats
• getblockchaininfo