api/v2/feestats - Bitcoin Cash

Example code for the api/v2/feestats REST method. Complete guide on how to use the api/v2/feestats REST method in the GetBlock Web3 documentation.

This endpoint returns fee statistics for the transactions in a single block, selected by height or hash. The load grows with the number of transactions in the block.

Parameters

Parameter	Type	Location	Required	Description
blockId	string	path	Yes	Block height or block hash

Request

cURL

curl --location --request GET 'https://go.getblock.io/<ACCESS-TOKEN>/api/v2/feestats/684634'

JavaScript

example.js

const response = await fetch(
    'https://go.getblock.io/<ACCESS-TOKEN>/api/v2/feestats/684634'
);
console.log(await response.json());

Python

example.py

import requests

response = requests.get('https://go.getblock.io/<ACCESS-TOKEN>/api/v2/feestats/684634')

print(response.json())

Response

{
    "txCount": 2815,
    "totalFeesSat": "12730055",
    "averageFeePerKb": 1240.5,
    "decilesFeePerKb": [
        500,
        780,
        900,
        1050,
        1180,
        1240,
        1310,
        1500,
        1820,
        2200,
        4200
    ]
}

Response Parameters

Field	Type	Description
txCount	integer	Number of transactions in the block
totalFeesSat	string	Total fees in the block, in satoshis
averageFeePerKb	number	Average fee rate in satoshis per kilobyte
decilesFeePerKb	array	Fee-rate deciles across the block's transactions

Use Cases

• Fee Market Analysis: Study the fee distribution within recent blocks

• Fee Modeling: Use deciles to model competitive fee rates

• Dashboards: Chart average and total fees per block

• Historical Study: Compare fee statistics across a range of blocks

Error Handling

HTTP Status	Message	Description
400	Bad request	The block height or hash is malformed
404	Not found	No block matches the requested height or hash
500	Internal error	The indexer failed to read the block