Flows

Contents

• Flows Received by Miners

• Flows Received One Hop from Miners

• Miner Net Flows

• Net Flows One Hop from Miners

• Flows Sent by Miners

• Flows Sent One Hop from Miners

• Miner Rolling Inventory, 30 day (%)

• Miner One Hop Rolling Inventory, 30 day (%)

Flows Received by Miners

Definition

The sum of block rewards, fees, and other transfers received by all mining entities during an interval, excluding transfers from another mining entity. A mining entity is defined as an address that has been credited from a transaction debiting the 'FEES' or 'ISSUANCE' accounts in accordance with Coin Metric’s Universal Blockchain Data Model (UBDM).

Name	MetricID	Unit	Interval
Flows Received by Miners (native units)	FlowMinerIn0HopAllNtv	Native units	1 day
Flows Received by Miners (USD)	FlowMinerIn0HopAllUSD	USD	1 day

Details

• This metric is not computed as the sum of block rewards and fees collected by all mining entities during an interval.

• For more details on how this metric is computed, please refer to our blog post introducing Miner Flows

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Flows Received One Hop from Miners

Defintion

The sum of block rewards, fees, and other transfers received by all addresses within one hop of a mining entity during an interval, excluding transfers from another address within one hop of a mining entity. An address within one hop of a mining entity is defined as an address that has been credited from a transaction debiting the 'FEES' or 'ISSUANCE' accounts in accordance with Coin Metric’s Universal Blockchain Data Model (UBDM).

Name	MetricID	Unit	Interval
Flows Received One Hop from Miners (native units)	FlowMinerIn1HopAllNtv	Native units	1 day
Flows Received One Hop from Miners (USD)	FlowMinerIn1HopAllUSD	USD	1 day

Details

• This metric is not computed as the sum of block rewards and fees collected by addresses within one hop of a mining entity during an interval.

• For more details on how this metric is computed, please refer to our blog post introducing Miner Flows

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Miner Net Flows

Definition

The net value sent or received by a mining entity in native units . A mining entity is defined as an address that has been credited from a transaction debiting the 'FEES' or 'ISSUANCE' accounts in accordance with Coin Metric’s Universal Blockchain Data Model (UBDM).

Name	MetricID	Unit	Interval
Miner Net Flows (native units)	FlowMinerNet0HopAllNtv	Native units	1 day
Miner Net Flows (native units)	FlowMinerNet0HopAllUSD	USD	1 day

Details

• For more details on how this metric is computed, please refer to our blog post introducing Miner Flows

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Net Flows One Hop from Miners

Definition

The difference between the sum of block rewards, fees, and other transfers received by all addresses within one hop of a mining entity during an interval, excluding transfers to another address within one hop of a mining entity, and those sent. An address within one hop of a mining entity is defined as an address that has been credited from a transaction debiting the 'FEES' or 'ISSUANCE' accounts in accordance with Coin Metric’s Universal Blockchain Data Model (UBDM), or any address that has been credited in a transaction sent by such an address.

Name	MetricID	Unit	Interval
Net Flows One Hop from Miners (native units)	FlowMinerNet1HopAllNtv	Native units	1 day
Net Flows One Hop from Miners (USD)	FlowMinerNet1HopAllUSD	USD	1 day

Details

• For more details on how this metric is computed, please refer to our blog post introducing Miner Flows

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Flows Sent by Miners

Definition

The sum of block rewards, fees, and other transfers received by all mining entities during an interval, excluding transfers from another mining entity. A mining entity is defined as an address that has been credited from a transaction debiting the 'FEES' or 'ISSUANCE' accounts in accordance with Coin Metric’s Universal Blockchain Data Model (UBDM).

Name	MetricID	Unit	Interval
Flows Sent by Miners (native units)	FlowMinerOut0HopAllNtv	Native units	1 day
Flows Sent by Miners (USD)	FlowMinerOut0HopAllUSD	USD	1 day

Details

• For more details on how this metric is computed, please refer to our blog post introducing Miner Flows

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Flows Sent One Hop from Miners

Definition

The sum of block rewards, fees, and other transfers sent by all addresses within one hop of a mining entity during an interval, excluding transfers to another address within one hop of a mining entity. An address within one hop of a mining entity is defined as an address that has been credited from a transaction debiting the 'FEES' or 'ISSUANCE' accounts in accordance with Coin Metric’s Universal Blockchain Data Model (UBDM), or any address that has been credited in a transaction sent by such an address.

Name	MetricID	Unit	Interval
Flows Sent One Hop from Miners (native units)	FlowMinerOut1HopAllNtv	Native units	1 day
Flows Sent One Hop from Miners (USD)	FlowMinerOut1HopAllUSD	USD	1 day

Details

• For more details on how this metric is computed, please refer to our blog post introducing Miner Flows

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Miner Rolling Inventory, 30 day (%)

Definition

The outflow from all mining entities divided by miner revenue, over a rolling window of 30 days.

Name	MetricID	Unit	Interval
Miner Rolling Inventory, 30 day (%)	MRI0HopAll30d	Percentage	30 days

Details

• This metric is computed as FlowMinerOut0HopAllNtv / RevNtv over a rolling window of 30 days

Asset-specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Miner One Hop Rolling Inventory, 30 day (%)

Definition

The outflow from all addresses within one hop of a mining entity divided by miner revenue, over a rolling window of 30 days.

Dictionary

Name	MetricID	Unit	Interval
Miner One Hop Rolling Inventory, 30 day (%)	MRI1HopAll30d	Percentage	30 days

Details

• This metric is computed as FlowMinerOut1HopAllNtv / RevNtv over a rolling window of 30 days

Asset-Specific Details

• This metric will initially only be available for Bitcoin.

Release History

• Release Version: NDP-EOD 4.8 (Nov, 2020)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

Flows metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's FlowMinerIn0HopAll*, FlowMinerIn1HopAll* FlowMinerNet0HopAll*``FlowMinerNet0HopAll*``FlowMinerOut0HopAll*``FlowMinerOut0HopAll*in the metrics parameter.

Asset metrics

Returns requested metrics for specified assets. Results for block by block metrics (1b frequency) are ordered by tuple (asset, height, block_hash), all other metrics are ordered by tuple (asset, time). You can change the sorting using sort query parameter. Supported output formats are json (default) and csv, use format query parameter to override it. To fetch the next page of results use next_page_url JSON response field or x-next-page-url CSV HTTP header if present. If multiple metrics are requested in the same time the strict policy for partially available metrics among requested ones is applied:

GEThttps://api.coinmetrics.io/v4/timeseries/asset-metrics

Authorization

api_key

Query parameters

Response

200400401403414

Time series of metrics for an asset.

Body

application/jsontext/csv

data*any

next_page_tokenNextPageToken (string)

Token of the next page results for a given request.

next_page_urlNextPageUrl (string)

URL of the next page results for a given request.

Request

ShellPython

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?assets=btc&metrics=PriceUSD,FlowInGEMUSD&frequency=1d&pretty=true&api_key=<your_key>"

Response

{
  "next_page_token": "text",
  "next_page_url": "text"
}

Shell

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

Python

import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=FlowMinerIn0HopAllNtv&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="FlowMinerIn0HopAllNtv", 
        assets="btc",
    ).to_dataframe()
)