BitcoinBitcoin API Endpoints

getblockstats

Calculates various statistics for a given block by hash or height.

⚠ This endpoint is only available with Blast access.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.
hash_or_heightstring or integerRequired

The block hash (string) or height (integer) of the target block.

statslist of stringsOptional
Optional list of specific stats to retrieve. If empty or omitted, returns all stats.

Response

A set of statistical metrics for the specified block.
avgfeeinteger or null

Average fee in the block (satoshis)

avgfeerateinteger or null
Average fee rate
avgtxsizeinteger or null
Average transaction size
blockhashstring or nullformat: "^[a-fA-F0-9]{64}$"

A 64-character hex string representing the block hash.

feerate_percentileslist of integers or null
Feerates at 10th, 25th, 50th, 75th, and 90th percentile
heightinteger or null>=0

The block height (index) used to fetch the block hash.

insinteger or null
Number of inputs
outsinteger or null
Number of outputs
maxfeeinteger or null
maxfeerateinteger or null
maxtxsizeinteger or null
medianfeeinteger or null
mediantimeinteger or null
mediantxsizeinteger or null
minfeeinteger or null
minfeerateinteger or null
mintxsizeinteger or null
subsidyinteger or null
swtotal_sizeinteger or null
swtotal_weightinteger or null
swtxsinteger or null
timeinteger or null
total_outinteger or null
total_sizeinteger or null
total_weightinteger or null
totalfeeinteger or null
txsinteger or null
utxo_increaseinteger or null
utxo_size_incinteger or null
utxo_increase_actualinteger or null
utxo_size_inc_actualinteger or null