Addresses with Balance

Contents

• Active Supply Percent

• Active Supply with Address Balance >= $X USD

• Active Supply with Address Balance >= X Native Units

• Supply Held By Smart Contracts

Val in Addrs w/ Bal ≥ X% of Current Supply

Definition

The sum of all native units being held in addresses whose balance was at least X% of the current supply of native units as the end of that day. Only native units are considered (e.g., an address with less than X ETH but with more than X in ERC-20 tokens would not be considered).

Dictionary

Name	MetricID	Unit	Interval
Val in Addrs w/ Bal ≥ .00000001% of Current Supply	SplyAdrBal1in10B	Native units	1 day
Val in Addrs w/ Bal ≥ .0000001% of Current Supply	SplyAdrBal1in1B	Native units	1 day
Val in Addrs w/ Bal ≥ .000001% of Current Supply	SplyAdrBal1in100M	Native units	1 day
Val in Addrs w/ Bal ≥ .00001% of Current Supply	SplyAdrBal1in10M	Native units	1 day
Val in Addrs w/ Bal ≥ .0001% of Current Supply	SplyAdrBal1in1M	Native units	1 day
Val in Addrs w/ Bal ≥ .001% of Current Supply	SplyAdrBal1in100K	Native units	1 day
Val in Addrs w/ Bal ≥ .01% of Current Supply	SplyAdrBal1in10K	Native units	1 day
Val in Addrs w/ Bal ≥ .1% of Current Supply	SplyAdrBal1in1K	Native units	1 day

Details

• The supply used is SplyCur

• The comparison is done using greater than or equal comparison (an address owning exactly 1/10,000,000,000th of the supply counts towards SplyAdrBal1in10B)

• For a day D, balances are taken at the end of that day.

• Only native units are taken into account, not L2 tokens.

Asset-Specific Details

• For XRP, escrows are taken into account.

• This metric is not available for assets that have full privacy, like Monero, Grin.

• For assets that have opt-in privacy features, like ZCash, it only takes the non-private balances into account.

Release History

• Released in the version 4.0 of Network Data Pro

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Val in Addrs w/ Bal ≥ $X (native units)

Definition

The sum of all native units being held in addresses whose balance was $1 or greater at the end of that day. Only native units are considered (e.g., an address with less than X ETH but with more than X in ERC-20 tokens would not be considered).

Dictionary

Name	MetricID	Unit	Interval
Val in Addrs w/ Bal ≥ $1 USD	SplyAdrBalUSD1	Native units	1 day
Val in Addrs w/ Bal ≥ $10 USD	SplyAdrBalUSD10	Native units	1 day
Val in Addrs w/ Bal ≥ $100 USD	SplyAdrBalUSD100	Native units	1 day
Val in Addrs w/ Bal ≥ $1K USD	SplyAdrBalUSD1k	Native units	1 day
Val in Addrs w/ Bal ≥ $10K USD	SplyAdrBalUSD10K	Native units	1 day
Val in Addrs w/ Bal ≥ $100K USD	SplyAdrBalUSD100K	Native units	1 day

Details

• This metric breaks down the supply of an asset by the USD balance of addresses owning it.

• For a day D, balances are taken at the end of that day, the price used it the close price for that day too.

• Only native units are taken into account, not L2 tokens.

• The comparison is done using greater than or equal comparison (an address owning exactly $1 counts towards SplyAdrBalUSD1).

Asset-Specific Details

• For Ripple, escrows are taken into account.

• This metric is not available for assets that have full privacy, like Monero, Grin.

• For assets that have opt-in privacy features, like ZCash, it only takes the non-private balances into account.

Release History

• Released in the 4.0 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Val in Addrs w/ Bal ≥ X (native units)

Definition

The sum of all native units being held in addresses whose balance was X native unit or greater at the end of that day. Only native units are considered (e.g., an address with less than X ETH but with more than X in ERC-20 tokens would not be considered).

Name	MetricID	Unit	Interval
Val in Addrs w/ Bal ≥ .001 (native units)	SplyAdrBalNtv0.001	Native units	1 day
Val in Addrs w/ Bal ≥ .01 (native units)	SplyAdrBalNtv0.001	Native units	1 day
Val in Addrs w/ Bal ≥ .001 (native units)	SplyAdrBalNtv0.1	Native units	1 day
Val in Addrs w/ Bal ≥ 1 (native units)	SplyAdrBalNtv1	Native units	1 day
Val in Addrs w/ Bal ≥ 10 (native units)	SplyAdrBalNtv10	Native units	1 day
Val in Addrs w/ Bal ≥ 100 (native units)	SplyAdrBalNtv100	Native units	1 day
Val in Addrs w/ Bal ≥ 1K (native units)	SplyAdrBalNtv1K	Native units	1 day
Val in Addrs w/ Bal ≥ 10K (native units)	SplyAdrBalNtv10K	Native units	1 day
Val in Addrs w/ Bal ≥ 100K (native units)	SplyAdrBalNtv100K	Native units	1 day

Details

• This metric breaks down the supply of an asset by the balance of addresses owning it.

• Only native units are taken into account, not L2 tokens.

• The comparison is done using greater than or equal comparison (an address owning exactly 1 native unit counts towards SplyAdrBalNtv1).

Asset-Specific Details

• For Ripple, escrows are taken into account.

• This metric is not available for assets that have full privacy, like Monero and Grin.

• For assets that have opt-in privacy features, like ZCash, it only takes the non-private balances into account.

Release History

Released in the 4.0 release of NDP

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

Supply Held by Smart Contracts

Definition

The sum of all native units being held by smart contracts.

Name	MetricID	Unit	Interval
Supply Held by Smart Contracts (native units)	SplyContNtv	Native units	1 day
Supply Held by Smart Contracts (USD)	SplyContUSD	Native units	1 day

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

Address with Balance Supply metrics can be accessed using these endpoints:

• timeseries/asset-metrics

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

Python

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