getblockstats | Alchemy Docs

1 import requests 2 3 url = "https://bitcoin-mainnet.alchemy-blast.com/v2/:apiKey" 4 5 payload = { "0": "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80" } 6 headers = {"Content-Type": "application/json"} 7 8 response = requests.post(url, json=payload, headers=headers) 9 10 print(response.json())

1 { 2 "jsonrpc": "2.0", 3 "id": "1", 4 "result": { 5 "avgfee": 1565, 6 "avgfeerate": 3, 7 "avgtxsize": 668, 8 "blockhash": "00000000000000000000669ed57030eb18020ee7029c064f10505156be203d80", 9 "feerate_percentiles": [ 10 2, 11 2, 12 3, 13 3, 14 4 15 ], 16 "height": 894470, 17 "ins": 7718, 18 "outs": 5666, 19 "maxfee": 376692, 20 "maxfeerate": 79, 21 "maxtxsize": 200604, 22 "medianfee": 453, 23 "mediantime": 1745928076, 24 "mediantxsize": 228, 25 "minfee": 141, 26 "minfeerate": 1, 27 "mintxsize": 150, 28 "subsidy": 312500000, 29 "swtotal_size": 1049707, 30 "swtotal_weight": 2349304, 31 "swtxs": 2075, 32 "time": 1745931642, 33 "total_out": 271147032190, 34 "total_size": 1460379, 35 "total_weight": 3991992, 36 "totalfee": 3420664, 37 "txs": 2186, 38 "utxo_increase": -2052, 39 "utxo_size_inc": -137484, 40 "utxo_increase_actual": -2841, 41 "utxo_size_inc_actual": -199799 42 } 43 }

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

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 stringsRequired

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

Response

A set of statistical metrics for the specified block.

avgfeeintegerOptional

Average fee in the block (satoshis)

avgfeerateintegerOptional

Average fee rate

avgtxsizeintegerOptional

Average transaction size

blockhashstringOptionalformat: "^[a-fA-F0-9]{64}$"

A 64-character hex string representing the block hash.

feerate_percentileslist of integersOptional

Feerates at 10th, 25th, 50th, 75th, and 90th percentile

heightintegerOptional>=0

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

insintegerOptional

Number of inputs

outsintegerOptional

Number of outputs

maxfeeintegerOptional

maxfeerateintegerOptional

maxtxsizeintegerOptional

medianfeeintegerOptional

mediantimeintegerOptional

mediantxsizeintegerOptional

minfeeintegerOptional

minfeerateintegerOptional

mintxsizeintegerOptional

subsidyintegerOptional

swtotal_sizeintegerOptional

swtotal_weightintegerOptional

swtxsintegerOptional

timeintegerOptional

total_outintegerOptional

total_sizeintegerOptional

total_weightintegerOptional

totalfeeintegerOptional

txsintegerOptional

utxo_increaseintegerOptional

utxo_size_incintegerOptional

utxo_increase_actualintegerOptional

utxo_size_inc_actualintegerOptional