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

# Flows

## Contents

* [Flows Received by Miners](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#flowminerin0hopall)
* [Flows Received One Hop from Miners](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#flowminerin1hopall)
* [Miner Net Flows](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#flowminernet0hopall)
* [Net Flows One Hop from Miners](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#flowminernet1hopall)
* [Flows Sent by Miners](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#flowminerout0hopall)
* [Flows Sent One Hop from Miners](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#flowminerout1hopall)
* [Miner Rolling Inventory, 30 day (%)](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#mri0hopall30d)
* [Miner One Hop Rolling Inventory, 30 day (%)](https://kb.talostrading.com/coinmetrics/network-data/network-data-overview/mining/flows.md#mri1hopall30d)

## 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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)

### Asset-Specific Details

* This metric will initially only be available for Bitcoin.

### Release History

* Release Version: 4.8 (Nov, 2020)

### Availability for Assets

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

## 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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)

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

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

## 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 (USD) | FlowMinerNet0HopAllUSD | 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)

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

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

## 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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)

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

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

## Flows Sent by Miners

### Definition

The sum of block rewards, fees, and other transfers sent 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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)

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

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

## 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](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-3e2)

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

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

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

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

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

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

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

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=FlowMinerIn0HopAllNtv&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=FlowMinerIn0HopAllNtv&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="FlowMinerIn0HopAllNtv", 
>         assets="btc",
>     ).to_dataframe()
> )
> ```
