getblockstats

getblockstats computes a compact set of statistics over a single Bitcoin block — average and median fees, the fee-rate percentiles, total and median size and weight, the input and output counts, the block subsidy, and the change in the UTXO set. It saves you from fetching the whole block and summing transactions yourself, which makes it ideal for fee analytics on the BTC network. You target a block by hash or height and may request a subset of stat names. Call it at https://bitcoin.therpc.io/YOUR_API_KEY; note that every fee and amount field comes back in satoshis (1 BTC = 100,000,000 sat).

Use cases

• Build a fee dashboard from the per-block feerate_percentiles to show what users paid to confirm.
• Chart total_size, total_weight, and txs across heights to track block usage over time.
• Read subsidy and totalfee for a height to see the full miner reward for that block.

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": "getblockstats",
8  "params": [
9    0,
10    []
11  ]
12}'

Errors & troubleshooting

Common pitfalls

• Every fee and amount field is in satoshis, not BTC — divide by 100,000,000 before showing a BTC figure.
• The target block must be on the active chain; stale-branch blocks are not supported and will not return stats.

Supported networks

• Mainnet
• Testnet

See also

• getblock
• getchaintxstats
• estimatesmartfee