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

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/height/698730/stats"

BTC

Example Response

BSV

{
    "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
}

BTC

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

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/hash/000000000000000002799ba826646d0060b06779e7bde9622145b410f114c1fb/stats"

BTC

Example Response

BSV

{
    "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
}

BTC

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

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/miner/blocks/stats?days=1"

BTC

Example Response

BSV

[{
    "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"
    }
},
...
]

BTC

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

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/miner/fees?from=1714608000&to=1714653060"

BTC

Example Response

BSV

[{
    "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
}]

BTC

URL Parameters

Parameter	Description
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.

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

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/miner/summary/stats?days=90"

BTC

Example Response

BSV

[{
    "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
            }
        },
        ...
    }
},
...
]

BTC

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

BSV

curl --location --request GET "https://api.whatsonchain.com/v1/bsv/main/block/tagcount/height/762291/stats"

BTC cURL

Example Response

BSV

{
    "count": 9128,
    "results": [{
        "name": "certihash",
        "count": 5588
    }, {
        "name": "my2cents",
        "count": 2320
    }, {
        "name": "run#cryptofights",
        "count": 709
    }, {
        "name": "OP_RETURN",
        "count": 144
    }, 
    ...
    ]
}

BTC

URL Parameters

Parameter	Description
chain	Desired blockchain: bsv or btc.
height	Block height.