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.

HTTP Request

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"

curl --location --request GET "https://api.whatsonchain.com/v1/btc/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
}

{
    "hash": "0000000000000000000a04cdff683678eb8c8cd62b56aed5418d779c322621a3",
    "tx_count": 2165,
    "height": 698730,
    "version": 939515908,
    "version_hex": "37ffe004",
    "merkle_root": "8bb0fd825e89d8af9231b5a667bd492f581d5404eeb771925354ae25c7de5620",
    "time": 1630606067,
    "median_time": 1630603713,
    "nonce": 1740888747,
    "bits": "170ffaa0",
    "difficulty": 17615033039278.88,
    "chainwork": "0000000000000000000000000000000000000000211d176a2da1d7170a5c7106",
    "miner_tag": "Braiins Pool",
    "total_fee": 12150237,
    "total_fee_usd": 5986.9442300910005,
    "total_out": 256922954942,
    "avg_fee": 5614,
    "avg_fee_usd": 2.766259202,
    "median_fee": 1565,
    "median_fee_usd": 0.771142795,
    "input_count": 6848,
    "output_count": 5676,
    "total_out_usd": 126596987.58698592,
    "subsidy": 625000000,
    "subsidy_usd": 307964.375,
    "reward": 637150237,
    "reward_usd": 313951.319230091,
    "coinbase": "036aa90afabe6d6d5a8485ec362d8087a524e5e2edf60a40dfa9cceefae429a37eb0c92395c5414601000000000000000a6507008d6a4f79fd2500000000009389b5b1182f736c7573682f",
    "size": 1310274,
    "exchange_rate": {
        "rate": 49274.3,
        "time": 1630540800
    },
    "min_tx_size": 188,
    "max_tx_size": 102754,
    "median_tx_size": 225,
    "avg_tx_size": 605,
    "cdd_total": 4622.627489398172
}

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

height

Block height.

Get Block Stats by Hash

This endpoint retrieves the block stats for a given hash.

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.

HTTP Request

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"

curl --location --request GET "https://api.whatsonchain.com/v1/btc/main/block/hash/0000000000000000000a04cdff683678eb8c8cd62b56aed5418d779c322621a3/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
}

{
    "hash": "0000000000000000000a04cdff683678eb8c8cd62b56aed5418d779c322621a3",
    "tx_count": 2165,
    "height": 698730,
    "version": 939515908,
    "version_hex": "37ffe004",
    "merkle_root": "8bb0fd825e89d8af9231b5a667bd492f581d5404eeb771925354ae25c7de5620",
    "time": 1630606067,
    "median_time": 1630603713,
    "nonce": 1740888747,
    "bits": "170ffaa0",
    "difficulty": 17615033039278.88,
    "chainwork": "0000000000000000000000000000000000000000211d176a2da1d7170a5c7106",
    "miner_tag": "Braiins Pool",
    "total_fee": 12150237,
    "total_fee_usd": 5986.9442300910005,
    "total_out": 256922954942,
    "avg_fee": 5614,
    "avg_fee_usd": 2.766259202,
    "median_fee": 1565,
    "median_fee_usd": 0.771142795,
    "input_count": 6848,
    "output_count": 5676,
    "total_out_usd": 126596987.58698592,
    "subsidy": 625000000,
    "subsidy_usd": 307964.375,
    "reward": 637150237,
    "reward_usd": 313951.319230091,
    "coinbase": "036aa90afabe6d6d5a8485ec362d8087a524e5e2edf60a40dfa9cceefae429a37eb0c92395c5414601000000000000000a6507008d6a4f79fd2500000000009389b5b1182f736c7573682f",
    "size": 1310274,
    "exchange_rate": {
        "rate": 49274.3,
        "time": 1630540800
    },
    "min_tx_size": 188,
    "max_tx_size": 102754,
    "median_tx_size": 225,
    "avg_tx_size": 605,
    "cdd_total": 4622.627489398172
}

URL Parameters

Parameter

Description

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.

Unidentified block miners are tagged as an empty string.

HTTP Request

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"

curl --location --request GET "https://api.whatsonchain.com/v1/btc/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"
    }
},
...
]

[{
    "header": {
        "size": 1609339,
        "height": 904982,
        "time": 1752185033
    },
    "stats": {
        "total_size": 1609339,
        "total_fee": 5703865
    },
    "details": {
        "miner_tag": "Foundry USA"
    }
}, {
    "header": {
        "size": 1531032,
        "height": 904983,
        "time": 1752185066
    },
    "stats": {
        "total_size": 1531032,
        "total_fee": 2141792
    },
    "details": {
        "miner_tag": "Foundry USA"
    }
},
...
]

URL Parameters

Parameter

Description

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.

Minimum fee rate is in sat/KB.

HTTP Request

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"

curl --location --request GET "https://api.whatsonchain.com/v1/btc/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
}]

[{
    "miner": "Binance Pool",
    "min_fee_rate": 1471.6703458425313
},{
    "miner": "F2Pool",
    "min_fee_rate": 2.7438016528925617
},{
    "miner": "Others",
    "min_fee_rate": 635.6877323420075
},{
    "miner": "MARA Pool",
    "min_fee_rate": 2038.4615384615383
},
...
]

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

from

Starting from as Unix timestamp.

Until to as Unix timestamp.

Get Miner Summary Stats

This endpoint retrieves the miner summary stats for specified number of days.

Unidentified block miners are tagged as an empty string.

HTTP Request

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"

curl --location --request GET "https://api.whatsonchain.com/v1/btc/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
            }
        },
        ...
    }
},
...
]

[{
    "period": 1744416000,
    "stats": {
        "": {
            "count": 7,
            "header": {
                "size": 9682966
            },
            "stats": {
                "total_size": 9682966,
                "total_fee": 35303459
            }
        },
        "AntPool": {
            "count": 27,
            "header": {
                "size": 35183506
            },
            "stats": {
                "total_size": 35183506,
                "total_fee": 87763130
            }
        },
        "Binance Pool": {
            "count": 5,
            "header": {
                "size": 7744328
            },
            "stats": {
                "total_size": 7744328,
                "total_fee": 20838766
            }
        },
        "CloverPool": {
            "count": 4,
            "header": {
                "size": 6619483
            },
            "stats": {
                "total_size": 6619483,
                "total_fee": 19247812
            }
        },
        ...
    }
},
...
]

URL Parameters

Parameter

Description

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.

HTTP Request

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"

curl --location --request GET "https://api.whatsonchain.com/v1/btc/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
    }, 
    ...
    ]
}

{
    "count": 1489,
    "results": [{
        "name": "stacks",
        "count": 6
    }, {
        "name": "nonstandard",
        "count": 1479
    }, {
        "name": "OP_RETURN",
        "count": 4
    }]
}

URL Parameters

Parameter

Description

chain

Desired blockchain: bsv or btc.

height

Block height.

Last updated 15 days ago

Was this helpful?