> ## Documentation Index
> Fetch the complete documentation index at: https://kb.talostrading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Balances

## Contents

* [Miner Supply](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/balances.md#splyminer0hopall)
* [Supply One Hop from Miners](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/balances.md#splyminer1hopall)

## 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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)
* This metric will initially only be available for Bitcoin.

### Release History

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

### Availability for Assets

[https://docs.coinmetrics.io/info/metrics/SplyMiner0HopAllNtv](https://docs.coinmetrics.io/info/metrics/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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)
* This metric will initially only be available for Bitcoin.

### Release History

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

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/SplyMiner1HopAllUSD](https://coverage.coinmetrics.io/asset-metrics/SplyMiner1HopAllUSD)

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

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=SplyMiner0HopAllNtv&assets=btc&pretty=true&api_key=<your_key>"
> ```

> [tab] Python
>
> ```python theme={null}
> 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)
> ```

> [tab] Python Client
>
> ```python theme={null}
> 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()
> )
> ```
