getblockstats

POST

/{apiKey}

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

Path Parameters

apiKeystringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request

hash_or_heightstring or integerrequired

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

statsstring[]optional

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

Responses

200

A set of statistical metrics for the specified block.

POST/v2/{apiKey}

curl --request POST \  --url https://bitcoin-mainnet.g.alchemy.com/v2/docs-demo \  --header 'Content-Type: application/json' \  --data '{  "jsonrpc": "2.0",  "id": 1,  "method": "getblockstats",  "params": [    "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80",    []  ]}'

200Success

{  "jsonrpc": "2.0",  "id": 1,  "result": {    "avgfee": 1565,    "avgfeerate": 3,    "avgtxsize": 668,    "blockhash": "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80",    "feerate_percentiles": [      2,      2,      3,      3,      4    ],    "height": 894470,    "ins": 7718,    "outs": 5666,    "maxfee": 376692,    "maxfeerate": 79,    "maxtxsize": 200604,    "medianfee": 453,    "mediantime": 1745928076,    "mediantxsize": 228,    "minfee": 141,    "minfeerate": 1,    "mintxsize": 150,    "subsidy": 312500000,    "swtotal_size": 1049707,    "swtotal_weight": 2349304,    "swtxs": 2075,    "time": 1745931642,    "total_out": 271147032190,    "total_size": 1460379,    "total_weight": 3991992,    "totalfee": 3420664,    "txs": 2186,    "utxo_increase": -2052,    "utxo_size_inc": -137484,    "utxo_increase_actual": -2841,    "utxo_size_inc_actual": -199799  }}

Was this page helpful?