Stats
Get Block Stats by Height
This endpoint retrieves the block stats for a given height.
Exchange rate information is not available for blocks processed before:
2018/11/19
for BSV.2010/07/18
for BTC.
Unidentified block miners are tagged as an empty string.
GET https://api.whatsonchain.com/v1/<chain>/main/block/height/<height>/stats
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/height/698730/stats"
Example Response
{
"hash": "000000000000000002799ba826646d0060b06779e7bde9622145b410f114c1fb",
"tx_count": 7088,
"height": 698730,
"version": 939515904,
"version_hex": "37ffe000",
"merkle_root": "58f529bbf8319340ee299a7b577177ca877ba3ecc2a4e8ef231ccd6387e9dbe6",
"time": 1627996871,
"median_time": 1627993031,
"nonce": 111084755,
"bits": "181112b7",
"difficulty": 64399232575.38872,
"chainwork": "0000000000000000000000000000000000000000012ef34e8452b98b968b3134",
"miner_tag": "qdlnk",
"total_fee": 9868209,
"total_fee_usd": 13.628983449900002,
"total_out": 58639450178,
"avg_fee": 1392,
"avg_fee_usd": 0.0019224912000000002,
"median_fee": 175,
"median_fee_usd": 0.00024169250000000004,
"input_count": 16930,
"output_count": 19002,
"total_out_usd": 80986.9446408358,
"subsidy": 625000000,
"subsidy_usd": 863.1875000000001,
"reward": 634868209,
"reward_usd": 876.8164834499001,
"coinbase": "036aa90a2f71646c6e6b2ff3d24370c50084e8887a0100",
"size": 17444558,
"exchange_rate": {
"rate": 138.11,
"time": 1627948800
},
"min_tx_size": 190,
"max_tx_size": 1151375,
"median_tx_size": 313,
"avg_tx_size": 2461,
"cdd_total": 200.48376520212884
}
URL Parameters
chain
Desired blockchain: bsv
or btc
.
height
Block height.
Get Block Stats by Hash
This endpoint retrieves the block stats for a given hash.
GET https://api.whatsonchain.com/v1/<chain>/main/block/hash/<hash>/stats
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/hash/000000000000000002799ba826646d0060b06779e7bde9622145b410f114c1fb/stats"
Example Response
{
"hash": "000000000000000002799ba826646d0060b06779e7bde9622145b410f114c1fb",
"tx_count": 7088,
"height": 698730,
"version": 939515904,
"version_hex": "37ffe000",
"merkle_root": "58f529bbf8319340ee299a7b577177ca877ba3ecc2a4e8ef231ccd6387e9dbe6",
"time": 1627996871,
"median_time": 1627993031,
"nonce": 111084755,
"bits": "181112b7",
"difficulty": 64399232575.38872,
"chainwork": "0000000000000000000000000000000000000000012ef34e8452b98b968b3134",
"miner_tag": "qdlnk",
"total_fee": 9868209,
"total_fee_usd": 13.628983449900002,
"total_out": 58639450178,
"avg_fee": 1392,
"avg_fee_usd": 0.0019224912000000002,
"median_fee": 175,
"median_fee_usd": 0.00024169250000000004,
"input_count": 16930,
"output_count": 19002,
"total_out_usd": 80986.9446408358,
"subsidy": 625000000,
"subsidy_usd": 863.1875000000001,
"reward": 634868209,
"reward_usd": 876.8164834499001,
"coinbase": "036aa90a2f71646c6e6b2ff3d24370c50084e8887a0100",
"size": 17444558,
"exchange_rate": {
"rate": 138.11,
"time": 1627948800
},
"min_tx_size": 190,
"max_tx_size": 1151375,
"median_tx_size": 313,
"avg_tx_size": 2461,
"cdd_total": 200.48376520212884
}
URL Parameters
chain
Desired blockchain: bsv
or btc
.
hash
Block hash.
Get Miner Block Stats
This endpoint retrieves the miner block stats for a specified number of days.
GET https://api.whatsonchain.com/v1/<chain>/main/miner/blocks/stats?days={days}
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/miner/blocks/stats?days=1"
Example Response
[{
"header": {
"size": 122926,
"height": 904971,
"time": 1752184082
},
"stats": {
"total_size": 122926,
"total_fee": 1341
},
"details": {
"miner_tag": "SA100"
}
}, {
"header": {
"size": 526989,
"height": 904972,
"time": 1752184167
},
"stats": {
"total_size": 526989,
"total_fee": 17769
},
"details": {
"miner_tag": "qdlnk"
}
},
...
]
URL Parameters
chain
Desired blockchain: bsv
or btc
.
days
The number of days to retrieve the data for. Only 1
or 30
days can be selected.
Get Miner Minimum Fee Rate Stats
This endpoint retrieves the miner minimum fee rate stats for a specified time period.
GET https://api.whatsonchain.com/v1/<chain>/main/miner/fees?from={from}&to={to}
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/miner/fees?from=1714608000&to=1714653060"
Example Response
[{
"miner": "taal.com",
"min_fee_rate": 1
},{
"miner": "CUVVE",
"min_fee_rate": 1.0003060717198577
},{
"miner": "GorillaPool.com 🦍",
"min_fee_rate": 1.001001001001001
},{
"miner": "qdlnk",
"min_fee_rate": 1.0001427259380782
}]
URL Parameters
chain
Desired blockchain: bsv
or btc
.
from
Starting from as Unix timestamp
.
to
Until to as Unix timestamp
.
Get Miner Summary Stats
This endpoint retrieves the miner summary stats for specified number of days.
GET https://api.whatsonchain.com/v1/<chain>/main/miner/summary/stats?days={days}
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/miner/summary/stats?days=90"
Example Response
[{
"period": 1744416000,
"stats": {
"CUVVE": {
"count": 38,
"header": {
"size": 2257161430
},
"stats": {
"total_size": 2257161430,
"total_fee": 6589515
}
},
"GorillaPool.com 🦍": {
"count": 4,
"header": {
"size": 86653775
},
"stats": {
"total_size": 86653775,
"total_fee": 333117
}
},
"Mining-Dutch": {
"count": 1,
"header": {
"size": 14891083
},
"stats": {
"total_size": 14891083,
"total_fee": 181009
}
},
"SA100": {
"count": 18,
"header": {
"size": 730803192
},
"stats": {
"total_size": 730803192,
"total_fee": 2836590
}
},
...
}
},
...
]
URL Parameters
chain
Desired blockchain: bsv
or btc
.
days
The number of days to retrieve the data for. Only 90
or 365
days can be selected.
Get Tag Count by Height
This endpoint retrieves stats on tag count for a specific block at a given height.
GET https://api.whatsonchain.com/v1/<chain>/main/block/tagcount/height/{height}/stats
Example Request
curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/tagcount/height/762291/stats"
Example Response
{
"count": 9128,
"results": [{
"name": "certihash",
"count": 5588
}, {
"name": "my2cents",
"count": 2320
}, {
"name": "run#cryptofights",
"count": 709
}, {
"name": "OP_RETURN",
"count": 144
},
...
]
}
URL Parameters
chain
Desired blockchain: bsv
or btc
.
height
Block height.
Last updated
Was this helpful?