# New Addresses ## Address Balances Addresses that hold a balance of X amount for a given asset. ### Contents * [New Funded Address Count (AdrNewBalCnt)](#adrnewbal) * [New Address Count (AdrNewCnt)](#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](https://coverage.coinmetrics.io/search-results?query=AdrNewBalCnt) | Addresses | 1 day | ### **Details** * [Addresses](/network-data/on-chain-basics.md#address) 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](https://docs.coinmetrics.io/asset-metrics/adresses/adrnewcnt) 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. ### **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](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/addresses/adrnewcnt.md) * [Address](/network-data/on-chain-basics.md#address) * [Active Addresses (Received)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/addresses/adractreccnt.md) * [Active Addresses (Sent)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/addresses/adractsentcnt.md) ### Availability for Assets {% embed url="" %} ## 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](https://coverage.coinmetrics.io/search-results?query=AdrNewCnt) | Addresses | 1 day | ### **Details** * [Addresses](/network-data/on-chain-basics.md#address) 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](https://docs.coinmetrics.io/asset-metrics/adresses/adrnewbalcnt) is a subset of New Addr Cnt that only counts addresses with a balance greater than 0. ### **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](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/addresses/adrnewbalcnt.md) * [Address](/network-data/on-chain-basics.md#address) * [Active Addresses (Received)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/addresses/adractreccnt.md) * [Active Addresses (Sent)](https://gitlab.com/coinmetrics/front-end/knowledge-base/-/blob/master/docs/network-data/addresses/adractsentcnt.md) ### Availability for Assets {% embed url="" %} ## 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. {% openapi src="/files/kc3C7O6zTLYNBA0AcsZt" path="/timeseries/asset-metrics" method="get" %} [openapi.yaml](https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-1522f16027d90845f8750dd9c51c03b8e7aab67f%2Fopenapi.yaml?alt=media) {% endopenapi %} {% tabs %} {% tab title="Shell" %} ```shell curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=AdrNewBal&assets=btc&pretty=true&api_key=" ``` {% endtab %} {% tab title="Python" %} ```python import requests response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=AdrNewBal&assets=btc&pretty=true&api_key=').json() print(response) ``` {% endtab %} {% tab title="Python Client" %} ```python from coinmetrics.api_client import CoinMetricsClient api_key = "" client = CoinMetricsClient(api_key) print( client.get_asset_metrics( metrics="AdrNewBal", assets="btc", ).to_dataframe() ) ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://gitbook-docs.coinmetrics.io/network-data/network-data-overview/addresses/new-addresses.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.