Balances

Contents

• Miner Supply

• Supply One Hop from Miners

Miner Supply

Definition

The sum of the balances of all mining entities. 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 Supply (native units)	SplyMiner0HopAllNtv	Native units	1 day
Miner Supply (USD)	SplyMiner0HopAllUSD	USD	1 day

Details

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

• This metric will initially only be available for Bitcoin.

Release History

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

Availability for Assets

SplyMiner0HopAllNtv

Supply One Hop from Miners

Definition

The sum of the balances of all addresses 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
Supply One Hop from Miners (native units)	SplyMiner1HopAllNtv	Native units	1 day
Supply One Hop from Miners (USD)	SplyMiner1HopAllUSD	USD	1 day

Details

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

• 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

Mining balance metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's SplyMiner{n}HopAll* 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.

Response

200400401403

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

Shell

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

Python

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