getchaintxstats - Dash
Example code for the getchaintxstats JSON-RPC method. Complete guide on how to use getchaintxstats JSON-RPC in GetBlock Web3 documentation.
This method computes statistics about the total number and rate of transactions in the chain over a window of blocks ending at a given block.
Parameters
nblocks
numeric
No
Size of the window in blocks. Default is one month of blocks
blockhash
string
No
Hash of the block that ends the window. Default is the chain tip
Request
curl --location --request POST 'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
"jsonrpc": "2.0",
"method": "getchaintxstats",
"params": [30, "0000000000000000023a561e1ea370153aac5d1504726d1a039032831c05fcfc"],
"id": "getblock.io"
}'const axios = require('axios');
const { data } = await axios.post('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/', {
jsonrpc: '2.0', method: 'getchaintxstats',
params: [30, '0000000000000000023a561e1ea370153aac5d1504726d1a039032831c05fcfc'], id: 'getblock.io'
});
console.log(data.result.txrate);import requests
response = requests.post(
'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/',
headers={'Content-Type': 'application/json'},
json={
'jsonrpc': '2.0',
'method': 'getchaintxstats',
'params': [30, "0000000000000000023a561e1ea370153aac5d1504726d1a039032831c05fcfc"],
'id': 'getblock.io'
}
)
print(response.json()['result'])Response
{
"error": null,
"id": "getblock.io",
"result": {
"time": 1617180599,
"txcount": 331847291,
"window_final_block_hash": "0000000000000000023a561e1ea370153aac5d1504726d1a039032831c05fcfc",
"window_final_block_height": 684634,
"window_block_count": 30,
"window_tx_count": 84213,
"window_interval": 18240,
"txrate": 4.618037
}
}Response Parameters
error
null|object
Error object when the call fails, otherwise null
id
string
Request identifier matching the request
result
object
Object of transaction statistics over the requested window
Result Object
txcount
numeric
Total transactions in the chain up to the final block
window_tx_count
numeric
Transactions in the window
window_interval
numeric
Elapsed time of the window in seconds
txrate
numeric
Average transactions per second over the window
Use Cases
Throughput Metrics: Report average transactions per second on a status page
Trend Analysis: Compare transaction rates across different windows
Capacity Planning: Assess sustained load when sizing infrastructure
Network Reports: Publish verified on-chain activity figures
Error Handling
-32700
Parse error
Request body is not valid JSON
-32600
Invalid request
The JSON sent is not a valid request object
-32603
Internal error
Node failed to read the requested chain state
Last updated
Was this helpful?