New Addresses

Address Balances

Addresses that hold a balance of X amount for a given asset.

Contents

• New Funded Address Count (AdrNewBalCnt)

• New Address Count (AdrNewCnt)

New Funded Address Count

Definition

The sum count of all unique addresses that were newly created and funded (e.g. have a non-zero balance) that interval.

Dictionary

Name	MetricID	Unit	Interval
New Addresses	AdrNewBalCnt	Addresses	1 day

Details

• Addresses are the user-identifiers in a ledger change.

• New addresses are addresses identified in the blockchain that did not exist prior to the observation period (e.g. 1 day).

• Depending upon how a blockchain stores address information, new addresses might not be funded with any tokens. In other words, they have a balance of zero.

• This metric only accounts for new addresses that have been funded.

Chart

New Addr Cnt showcases all new addresses observed in the network over the previous day, and New Funded Addr Cnt is a subset of New Addr Cnt that only counts addresses with a balance greater than 0.

Source: CM Network Data Charts

Asset-Specific Details

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 activities into account.

Examples

Consider the following example:

• Both Addreses A and Address B are seen on the ledger for the first time.

• Address A was referred by a smart contract application, perhaps as user identifier, but it was not funded or otherwise engaged by the smart contract. Its balance is zero.

• During that same interval, Address B received funds from an exhange for the first time. Its balance is 0.002.

If the above was the only activity observed in the network during that interval, AdrNewCnt would showcase a value of 1. This value only aggregates activity that is economically relevant (Address B), and excludes non-monetary activity (Address A).

Release History

• Release Version: 5.0 (August, 2021)

Interpretation

• Like Active Addresses, New Funded Addresses is a popular measure to proxy the number of new users on a blockchain. Unlike New Addr Cnt, this only showcases addresses with a non-zero balance .

See Also

• New Addr Cnt

• Address

• Active Addresses (Received)

• Active Addresses (Sent)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

New Address Count

Definition

The sum count of all unique addresses that were newly created that interval.

Dictionary

Name	MetricID	Unit	Interval
New Addresses	AdrNewCnt	Addresses	1 day

Details

• Addresses are the user-identifiers in a ledger change.

• New addresses are addresses identified in the blockchain that did not exist prior to the observation period (e.g. 1 day).

• Depending upon how a blockchain stores address information, new addresses might not be funded with any tokens. In other words, they have a balance of zero.

• As such, a caveat of this metric is that it can be inflated by activity that is not economicallt relevant.

• For new addresses that are funded and are economically relevant, please refer to New Funded Adrr Cnt (AdrNewBalCnt).

Chart

New Addr Cnt showcases all new addresses observed in the network over the previous day, and New Funded Addr Cnt is a subset of New Addr Cnt that only counts addresses with a balance greater than 0.

Source: CM Network Data Charts

Asset-Specific Details

• 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 activities into account.

Examples

Consider the following example:

• Both Addreses A and Address B are seen on the ledger for the first time.

• Address A was referred by a smart contract application, perhaps as user identifier, but it was not funded or otherwise engaged by the smart contract. Its balance is zero.

• During that same interval, Address B received funds from an exhange for the first time. Its balance is 0.002.

If the above was the only activity observed in the network during that interval, AdrNewCnt would showcase a value of 2. This value aggregates activity that is economically relevant (Address B) as well as non monetary (Address A).

Release History

• Release Version: 5.0 (August, 2021)

Interpretation

• Like Active Addresses, New Addresses is a popular measure to proxy the number of new users on a blockchain. However, in blockchains where address creation is cheap, or free, new addresses can still be trivially forged.

See Also

• New Funded Addr Cnt

• Address

• Active Addresses (Received)

• Active Addresses (Sent)

Availability for Assets

Coin Metrics CoverageCoin Metrics Coverage

API Endpoints

New Address metrics can be accessed using these endpoints:

• timeseries/asset-metrics

and by passing in the metric IDs AdrNewBal AdrNewCnt 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.

Request

ShellPython

curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?assets=btc&metrics=PriceUSD,FlowInGEMUSD&frequency=1d&pretty=true&api_key=<your_key>"

Response

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

Shell

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

Python

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