Flows

Contents

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).

NameMetricIDUnitInterval

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

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).

NameMetricIDUnitInterval

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

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).

NameMetricIDUnitInterval

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

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.

NameMetricIDUnitInterval

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

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).

NameMetricIDUnitInterval

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

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.

NameMetricIDUnitInterval

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

Miner Rolling Inventory, 30 day (%)

Definition

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

NameMetricIDUnitInterval

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

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

NameMetricIDUnitInterval

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

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
Query parameters
Response

Time series of metrics for an asset.

Body
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
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"
}
curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=FlowMinerIn0HopAllNtv&assets=btc&pretty=true&api_key=<your_key>"

Last updated