# Addresses with Balance

## Contents

* [Active Supply Percent](/network-data/network-data-overview/supply/active-supply.md#splyactpct)
* [Active Supply with Address Balance >= $X USD](/network-data/network-data-overview/supply/active-supply.md#splyactusd)
* [Active Supply with Address Balance >= X Native Units](/network-data/network-data-overview/supply/active-supply.md#splyactusd)
* [Supply Held By Smart Contracts](/network-data/network-data-overview/supply/active-supply.md#splycont)

## Val in Addrs w/ Bal ≥ X% of Current Supply <a href="#splyactpct" id="splyactpct"></a>

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

<table data-header-hidden><thead><tr><th>Name</th><th width="196">MetricID</th><th>Unit</th><th>Interval</th></tr></thead><tbody><tr><td>Name</td><td>MetricID</td><td>Unit</td><td>Interval</td></tr><tr><td>Val in Addrs w/ Bal ≥ .00000001% of Current Supply</td><td>SplyAdrBal1in10B</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .0000001% of Current Supply</td><td>SplyAdrBal1in1B</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .000001% of Current Supply</td><td>SplyAdrBal1in100M</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .00001% of Current Supply</td><td>SplyAdrBal1in10M</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .0001% of Current Supply</td><td>SplyAdrBal1in1M</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .001% of Current Supply</td><td>SplyAdrBal1in100K</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .01% of Current Supply</td><td>SplyAdrBal1in10K</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ .1% of Current Supply</td><td>SplyAdrBal1in1K</td><td>Native units</td><td>1 day</td></tr></tbody></table>

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/SplyAdrBal1in10B>" %}

## Val in Addrs w/ Bal ≥ $X (native units) <a href="#splyactusd" id="splyactusd"></a>

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

<table><thead><tr><th>Name</th><th width="179">MetricID</th><th>Unit</th><th>Interval</th></tr></thead><tbody><tr><td>Val in Addrs w/ Bal ≥ $1 USD</td><td>SplyAdrBalUSD1</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ $10 USD</td><td>SplyAdrBalUSD10</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ $100 USD</td><td>SplyAdrBalUSD100</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ $1K USD</td><td>SplyAdrBalUSD1k</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ $10K USD</td><td>SplyAdrBalUSD10K</td><td>Native units</td><td>1 day</td></tr><tr><td>Val in Addrs w/ Bal ≥ $100K USD</td><td>SplyAdrBalUSD100K</td><td>Native units</td><td>1 day</td></tr></tbody></table>

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/SplyAdrBalUSD1>" %}

## Val in Addrs w/ Bal ≥ X (native units) <a href="#splyactntv" id="splyactntv"></a>

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/SplyAdrBalNtv1>" %}

## Supply Held by Smart Contracts <a href="#splycont" id="splycont"></a>

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

{% embed url="<https://coverage.coinmetrics.io/asset-metrics/SplyContNtv>" %}

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

{% 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-a236d0d04b3b155748ce07a17aca8108fce9b7c2%2Fopenapi.yaml?alt=media)
{% endopenapi %}

{% tabs %}
{% tab title="Shell" %}

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

{% endtab %}

{% tab title="Python" %}

```python
import requests
response = requests.get('https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=SplyAdrBal1in100K&assets=btc&pretty=true&api_key=<your_key>').json()
print(response)
```

{% endtab %}

{% tab title="Python Client" %}

```python
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()
)
```

{% 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/supply/addresses-with-balance.md?ask=<question>
```

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.