# Free Float Supply

## Contents

* [Free Float Supply](#splyff)

## Free Float Supply (native units) <a href="#splyff" id="splyff"></a>

### Definition

The sum of all native units ever created and visible on the ledger excluding native units held closely by company insiders, controlling investors and long term strategic holders as of that day.

| Name                             | MetricID | Unit         | Interval |
| -------------------------------- | -------- | ------------ | -------- |
| Free Float Supply (native units) | SplyFF   | Native units | All time |

### Details

* Free Float Supply is a measure of supply that excludes tokens are locked up or dormant for a long time. For example, tokens that are inactive for greater than five years, owned by company, blockchain foundation or founding team member(s) that may or may not be subject to escrows, burnt or lost, etc.
* Our free float value constantly shows a lower value than either the reported supply by foundations/companies or total visible on-chain supply.
* Please refer to the CMBI Adjusted Free Float Methodology for asset treatment: <https://coinmetrics.io/wp-content/uploads/2021/01/CMBI-Adjusted-Free-Float-Methodology-v1.0.pdf>
* For supported assets and tagged addresses, please refer to the CM gitlab SplyFF.json

### Chart

<figure><img src="https://2398817338-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MO23j33wWGzm0NrZseN%2Fuploads%2Fgit-blob-bd2d5ebe995214898139be4ba3146114d50e6625%2FCoin_Metrics_Network_Data_2022-09-16T13-45.png?alt=media" alt=""><figcaption><p>Source: Network Data Charts</p></figcaption></figure>

### Release History

* Released in the 4.8 release of NDP
* Free Float expanded to DOT, UNI, UMA, Aave, Yearn, Curve, REN, and BAL in the 4.9 release of NDP

### Asset-Specific Details

* ETH Free Float Supply includes tokens on the Consensus Layer and Execution Layer\\

### **See Also**

* [Introducing Fee Float Supply](https://coinmetrics.io/introducing-free-float-supply/)
* [Creating a Better Supply Measurement: Free Float Supply](https://coinmetrics.substack.com/p/coin-metrics-state-of-the-network-7d0)
* Quarterly Transparency Reports (in [Original Research](https://coinmetrics.io/insights/original-research/))

### **Availability for Assets**

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

## API Endpoints

Free Float Supply metrics can be accessed using these endpoints:

* `timeseries/asset-metrics`

and by passing in the metric ID's `SplyBurnt*` in the `metrics` parameter.

{% openapi src="<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>" 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=SplyFF&assets=eth&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=SplyFF&assets=eth&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="SplyFF", 
        assets="eth",
    ).to_dataframe()
)
```

{% endtab %}
{% endtabs %}