Blocks

Contents

• Block Count at Tip

• Block Count by Same Miner

• Blocks by Unknown Miners

• Blocks Without Segwit

Block Count at Tip

Definition

The number of blocks identified at the chain tip.

Dictionary

Name	MetricID	Category	Sub-category	Type	Unit	Interval
Block Count at Tip	block_count_at_tip	KRI	Block Attributes	Sum	Count of tips	1b

Methodology

Counts the number of unique block hashes at the tip of the chain and returns that number. More than one block count at the tip of the chain indiciates a fork in the chain.

Available Assets

Bitcoin (BTC), Ethereum (ETH)

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc,eth&frequency=1b&metrics=block_count_at_tip&pretty=trueapi.coinmetrics.io

Block Count by Same Miner

Definition

The number of blocks mined by the same miner in the past 6 blocks.

Dictionary

Name	MetricID	Category	Sub-category	Type	Unit	Interval
Block Count by Same Miner	block_count_by_same_miner_6b	KRI	Block Attributes	Sum	Coun of Blocks	1b

Methodology

The 6 blocks from the tip of the blockchain (including the most recent block) are assessed. Coin Metric employs a proprietary entity clustering methodology in order to identify major mining pools & miners. The coinbase output field used by miners to self-identify is also used to help assess miner identities.

Available Assets

Bitcoin (BTC), Ethereum (ETH)*.

* Historical data covering the pre-merge timeframe only (up to 9/15/2022). With the merge ETH switched from Proof of Work and miners to Proof of Stake and validators meaning the network no longer has any miners as of the merge date.

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&metrics=block_count_by_same_miner_6b&pretty=trueapi.coinmetrics.io

Blocks by Unknown Miners

Definition

The count of blocks that have been mined by unknown miners 6 blocks from the tip of the blockchain.

Dictionary

Name	MetricID	Category	Sub-category	Type	Unit	Interval
Blocks by unknown miner	block_count_by_unknown_miners_6b	KRI	Mining Pools	Sum	Count of blocks	1 block

Methodology

The 6 blocks from the tip of the blockchain (including the most recent block) are assessed. Coin Metric employs a proprietary entity clustering methodology in order to identify major mining pools & miners. The coinbase output field used by miners to self-identify is also used to help assess miner identities.

Available Assets (v1)

Bitcoin (BTC), Ethereum (ETH)*.

* Historical data covering the pre-merge timeframe only (up to 9/15/2022). With the merge ETH switched from Proof of Work and miners to Proof of Stake and validators meaning the network no longer has any miners as of the merge date.

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&limit_per_asset=1&metrics=block_count_by_unknown_miners_6b&pretty=trueapi.coinmetrics.io

Non SegWit Blocks

Definition

The number of blocks without SegWit transactions in the past 6 blocks.

Dictionary

Name	MetricID	Category	Sub-category	Type	Unit	Interval
Non segwit blocks	block_count_without_segwit_6b	KRI	Block Attributes	Sum	Number of blocks	1 block

Methodology

The 6 blocks from the tip of the blockchain (including the most recent block) are assessed, and the number of blocks without SegWit transactions is counted.

Available Assets

Bitcoin (BTC)

Sample Query

https://api.coinmetrics.io/v4/timeseries/asset-metrics?api_key=%3Cyour_key%3E&assets=btc&frequency=1b&limit_per_asset=1&metrics=block_count_without_segwit_6b&pretty=trueapi.coinmetrics.io

API Endpoints

Blocks metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's block_count* in the metrics parameter.

Shell

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=block_count_at_tip&assets=btc&pretty=true&api_key=<your_key>"

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=block_count_at_tip&assets=btc&pretty=true&api_key=<your_key>').json()
print(response)

Python Client

from coinmetrics.api_client import CoinMetricsClient

api_key = "<API_KEY>"
client = CoinMetricsClient(api_key)

print(
    client.get_asset_metrics(
        metrics="block_count_at_tip", 
        assets="btc",
    ).to_dataframe()
)