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.

• Unidentified block miners are tagged as an empty string.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/main/block/height/<height>/stats

cURL

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

Response JSON structure

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

URL Parameters

Parameter	Description
network	The selected network: main.
height	The height of the block to retrieve.

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.

• Unidentified block miners are tagged as an empty string.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/main/block/hash/<hash>/stats

cURL

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

Response JSON structure

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

URL Parameters

Parameter	Description
network	The selected network: main.
hash	The hash of the block to retrieve.

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/bsv/main/miner/blocks/stats?days={days}

cURL

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

Response JSON structure

[
  {
    "header": {
      "size": 297234612,
      "height": 757673,
      "time": 1663491738
    },
    "stats": {
      "total_size": 297234612,
      "total_fee": 23803452
    },
    "details": {
      "miner_tag": "taal.com"
    }
  },
  ...
 ]

URL Parameters

Parameter	Description
network	The selected network: main.
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/bsv/main/miner/fees?from={from}&to={to}

cURL

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

Response JSON structure

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

Parameter	Description
network	The selected network: main.
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 days over a 24 hour period.

• Unidentified block miners are tagged as an empty string.

HTTP Request

GET https://api.whatsonchain.com/v1/bsv/main/miner/summary/stats?days={days}

cURL

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

Response JSON structure

[
  {
    "period": 1658275200,
    "stats": {
      "": {
        "count": 3,
        "header": {
          "size": 520
        },
        "stats": {
          "total_size": 520,
          "total_fee": 63057
        }
      },
      "GorillaPool.com 🦍": {
        "count": 1,
        "header": {
          "size": 148698760
        },
        "stats": {
          "total_size": 148698760,
          "total_fee": 6068680
        }
      },
      "Mining-Dutch": {
        "count": 2,
        "header": {
          "size": 1072828
        },
        "stats": {
          "total_size": 1072828,
          "total_fee": 789414
        }
      },
      "SBICrypto.com": {
        "count": 30,
        "header": {
          "size": 28091831
        },
        "stats": {
          "total_size": 28091831,
          "total_fee": 21344586
        }
      },
      "SVpool": {
        "count": 9,
        "header": {
          "size": 480750592
        },
        "stats": {
          "total_size": 480750592,
          "total_fee": 44484376
        }
      },
      "qdlnk": {
        "count": 21,
        "header": {
          "size": 1409145367
        },
        "stats": {
          "total_size": 1409145367,
          "total_fee": 74006627
        }
      },
      "taal.com": {
        "count": 17,
        "header": {
          "size": 978720432
        },
        "stats": {
          "total_size": 978720432,
          "total_fee": 51728556
        }
      }
    }
  },
  ...
 ]

URL Parameters

Parameter	Description
network	The selected network: main.
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/bsv/main/block/tagcount/height/{height}/stats

cURL

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

Response JSON structure

{
  "count": 9128,
  "results": [
    {
      "name": "certihash",
      "count": 5588
    },
    {
      "name": "my2cents",
      "count": 2320
    },
    {
      "name": "run#cryptofights",
      "count": 709
    },
    {
      "name": "OP_RETURN",
      "count": 152
    },
    {
      "name": "bitcom#B",
      "count": 124
    },
    {
      "name": "bitcom#D",
      "count": 123
    },
    {
      "name": "peergame.com",
      "count": 29
    },
    {
      "name": "Badge",
      "count": 17
    },
    {
      "name": "nonstandard",
      "count": 15
    },
    {
      "name": "run",
      "count": 12
    },
    {
      "name": "STAS",
      "count": 11
    },
    {
      "name": "run#relayx.io",
      "count": 6
    },
    {
      "name": "tdxp.app",
      "count": 5
    },
    {
      "name": "bitcom",
      "count": 4
    },
    {
      "name": "bitcom#twetch",
      "count": 4
    },
    {
      "name": "haste arcade",
      "count": 4
    },
    {
      "name": "metanet#metaid",
      "count": 3
    },
    {
      "name": "DotWallet",
      "count": 2
    }
  ]
}

URL Parameters

Parameter	Description
network	The selected network: main.
height	The height of the block.