Net Flows

Contents

• Net Flows (FlowNetXNtv)

Net Flows

Definiton

The net unit value sent or withdrawn to/from an exchange in that interval.

Name	MetricID	Unit	Interval
Bitfinex Net Flows (native units)	FlowNetBFXNtv	Native units	1 day
Bitfinex Net Flows (USD)	FlowNetBFXUSD	USD	1 day
BitMEX Net Flows (native units)	FlowNetBMXNtv	Native units	1 day
BitMEX Net Flows (USD)	FlowNetBMXUSD	USD	1 day
Binance Net Flows (native units)	FlowNetBNBNtvFlow	Native units	1 day
Binance Net Flows (USD)	FlowNetBNBUSD	USD	1 day
Bitstamp Net Flows (native units)	FlowNetBSPNtv	Native units	1 day
Bitstamp Net Flows (USD)	FlowNetBSPUSD	USD	1 day
Bittrex Net Flows (native untis)	FlowNetBTXNtvFlow	Native units	1 day
Bittrex Net Flows (USD)	FlowNetBTXUSD	USD	1 day
Gemini Net Flows (native units)	FlowNetGEMNtv	Native units	1 day
Gemini Net Flows (USD)	FlowNetGEMUSD	USD	1 day
Huobi Net Flows (native units)	FlowNetHUONtv	Native units	1 day
Huobi Net Flows (USD)	FlowNetHUOUSD	USD	1 day
Kraken Net Flows (native units)	FlowNetKRKNtv	Native units	1 day
Kraken Net Flows (USD)	FlowNetKRKUSD	USD	1 day
Poloniex Net Flows (native units)	FlowNetPOLNtv	Native units	1 day
Poloniex Net Flows (USD)	FlowNetPOLUSD	USD	1 day

Details

• Native units are considered as sent to an exchange if they are sent to an address we identify as being owned by an exchange.

• Native units are considered as withdrawn if they leave the control of an address we identify as being owned by an exchange.

• This metric is the net of the sends and withdrawals that interval.

• USD metrics are computed as FlowNet{Exchange}Ntv * PriceUSD

Asset-Specific Details

• This metric might not be available for all assets. Either that exchange doesn’t support this asset (BitMEX only trades in BTC for example), or we deemed that our coverage of the exchange was not complete enough to release the metric for it.

• For Bitcoin, this metric excludes the effect of change outputs:

  • If a transaction sends 90 BTC to exchange A but also withdraws 50 BTC from it, the flow is +40 BTC, not +90 BTC and -50 BTC.

Release History

• Released in the 4.0 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

Net Flow metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric ID's FlowNet* 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=FlowNetBFXNtv&assets=btc&pretty=true&api_key=<your_key>"

Python

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