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

# Asset Supply

> Circulating and total token supply of an asset over time. Each series is one asset, keyed by its asset id. Tracks emissions and unlocks, or rebuilds market cap together with asset-price.

|                  |                                                                                                            |
| ---------------- | ---------------------------------------------------------------------------------------------------------- |
| Access           | Paid                                                                                                       |
| Timeseries model | `asset-supply`: intervals `1d`, `1w`, series key `id` (Asset ID), series must be named (up to 20 per call) |

## Endpoints

<CardGroup cols={2}>
  <Card title="Batch Get Asset timeseries" icon="arrow-right" href="/api-reference/data-api/assets/timeseries-asset-supply">
    Up to 20 series in one request, named by Asset ID in `series`.
  </Card>

  <Card title="Get Asset timeseries" icon="arrow-right" href="/api-reference/data-api/assets/timeseries-asset-supply-by-id">
    One series over a time window, keyed by its Asset ID.
  </Card>
</CardGroup>

## Metrics

2 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field                | Name               | Type    | Unit | Description                                                                                                          |
| -------------------- | ------------------ | ------- | ---- | -------------------------------------------------------------------------------------------------------------------- |
| `circulating-supply` | Circulating Supply | float64 |      | The number of tokens that exist, excluding those that are locked in contracts or otherwise not available for trading |
| `total-supply`       | Total Supply       | float64 |      | The total number of tokens that exist                                                                                |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/asset-supply/1d/1e31218a-e44e-4285-820c-8282ee222035?timeframe=7d&selections=circulating-supply,total-supply" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Asset timeseries](/api-reference/data-api/assets/timeseries-asset-supply-by-id) for the response and the errors.