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

> Market capitalization of an asset over time: circulating market cap, its dominance of the total crypto market and fully diluted valuation, in USD. Each series is one asset, keyed by its asset id.

|                  |                                                                                                                     |
| ---------------- | ------------------------------------------------------------------------------------------------------------------- |
| Access           | Paid                                                                                                                |
| Timeseries model | `asset-marketcap`: intervals `1h`, `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-marketcap">
    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-marketcap-by-id">
    One series over a time window, keyed by its Asset ID.
  </Card>
</CardGroup>

## Metrics

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

| Field                             | Name                            | Type    | Unit    | Description                                                                                                                         |
| --------------------------------- | ------------------------------- | ------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| `circulating-marketcap`           | Circulating Marketcap           | float64 | usd     | The market capitalization of the asset, calculated using the circulating supply                                                     |
| `circulating-marketcap-dominance` | Circulating Marketcap Dominance | float64 | percent | The market capitalization of the asset as a percentage of the total market capitalization of all crypto assets                      |
| `fully-diluted-marketcap`         | Fully Diluted Marketcap         | float64 | usd     | The market capitalization of the asset, calculated using the fully diluted supply. Commonly known as Fully Diluted Valuation (FDV). |

## Example

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

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