> ## Documentation Index
> Fetch the complete documentation index at: https://kb.talostrading.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Addresses with Balance

## Contents

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

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

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

[https://coverage.coinmetrics.io/asset-metrics/SplyAdrBal1in10B](https://coverage.coinmetrics.io/asset-metrics/SplyAdrBal1in10B)

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

<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

[https://coverage.coinmetrics.io/asset-metrics/SplyAdrBalUSD1](https://coverage.coinmetrics.io/asset-metrics/SplyAdrBalUSD1)

## 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) | SplyAdrBalNtv001 | Native units | 1 day |
| Val in Addrs w/ Bal ≥ .1 (native units) | SplyAdrBalNtv01 | 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

[https://coverage.coinmetrics.io/asset-metrics/SplyAdrBalNtv1](https://coverage.coinmetrics.io/asset-metrics/SplyAdrBalNtv1)

## 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 | USD | 1 day |

### Availability for Assets

[https://coverage.coinmetrics.io/asset-metrics/SplyContNtv](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.

`GET /timeseries/asset-metrics`

> [tab] Shell
>
> ```shell theme={null}
> curl --compressed "https://api.coinmetrics.io/v4/timeseries/asset-metrics?metrics=SplyAdrBal1in100K&assets=btc&pretty=true&api_key=<your_key>"
> ```

> [tab] Python
>
> ```python theme={null}
> 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)
> ```

> [tab] Python Client
>
> ```python theme={null}
> 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()
> )
> ```
