> ## Documentation Index > Fetch the complete documentation index at: https://docs.cryptoquant.com/llms.txt > Use this file to discover all available pages before exploring further. # Supply > Metrics on the supply of the asset — how much of it exists, and how that changed in the window. ## What it measures Metrics on the supply of the asset — how much of it exists, and how that changed in the window. The exact set of fields depends on the asset class: native ETH reports issuance, ERC-20 tokens report mints and burns, and stablecoins additionally separate circulating supply from total supply. ## Assets and windows This endpoint serves 4 asset classes. **The available windows differ by class** — a window that works for one asset can return `400` for another. | Asset class | What it covers | Assets | Windows | | - | - | - | - | | **Bitcoin** | the native asset of Bitcoin, `asset=btc` | `btc` | `block` · `hour` · `day` | | **Native ETH** | the native asset, `asset=eth` | `eth` | `block` · `10min` · `hour` · `day` | | **ERC-20** | ERC-20 tokens | 198 assets | `block` · `10min` · `hour` · `day` | | **Stablecoin** | stablecoins issued on Ethereum | 76 assets | `block` · `10min` · `hour` · `day` | The default window is `day`. A request for a window that the asset's class does not support returns `400` and lists the windows that asset does support. ## Response fields The time key depends on the window: `datetime` for `day`, `10min`, and `hour` and `blockheight` plus `datetime` for `block`. | Field | Type | Asset classes | Description | | - | - | - | - | | `supply_new` | number | `btc`, `eth` | The amount newly issued in the window. Native assets only (`eth`, `btc`) — issuance comes from block rewards. | | `supply_total` | number | all | The total amount of the asset in existence. | | `supply_minted` | number | `erc20`, `stablecoin` | The amount minted in the window (an increase in total supply). | | `supply_burned` | number | `erc20`, `stablecoin` | The amount burned in the window (a decrease in total supply). | | `supply_circulating` | number | `stablecoin` | An approximation of the amount circulating in the market — total supply less balances held by the issuer (e.g. treasury addresses). | | `supply_issued` | number | `stablecoin` | The amount issued to clients in the window (an increase in circulating supply). | | `supply_redeemed` | number | `stablecoin` | The amount redeemed in the window (a decrease in circulating supply). | ## OpenAPI ````yaml openapi/v2-onchain.json GET /network/supply openapi: 3.0.0 info: version: 2.0.0-beta title: CryptoQuant Data API v2 — On-chain description: >- On-chain endpoints of the CryptoQuant Data API v2 — network activity, exchange and mining pool flows, indicators, and capitalization, for Bitcoin and for Ethereum with the ERC-20 and stablecoin assets issued on it. One path serves every asset: the asset is a query parameter, not part of the path. Built on the v1 conventions: the `status`/`result` envelope, Bearer token authentication, and the `window`/`from`/`to` time parameters. termsOfService: https://cryptoquant.com/terms-of-service contact: name: API Support email: contact@cryptoquant.com servers: - url: https://api.cryptoquant.com/v2 description: Default server security: [] tags: - name: Network Data - name: Exchange Flows - name: Mining Pool Flows - name: Inter-Entity Flows - name: Indicator - name: Market Data paths: /network/supply: get: tags: - Network Data summary: Supply description: >- Metrics on the supply of the asset — how much of it exists, and how that changed in the window. The exact set of fields depends on the asset class: native ETH reports issuance, ERC-20 tokens report mints and burns, and stablecoins additionally separate circulating supply from total supply. operationId: V2NetworkSupply parameters: - name: asset in: query required: true description: >- Asset to query, by its CryptoQuant alias (no chain suffix — `usdt`, not `usdt_eth`). 276 assets are available on this endpoint, across the asset classes `btc`, `erc20`, `eth`, `stablecoin`. Enumerate them with `/v2/discovery/endpoints`. schema: type: string example: eth - name: chain in: query required: false description: >- Chain the asset lives on. Optional for an asset that exists on exactly one chain, required when the same alias exists on several. schema: type: string enum: - bitcoin - ethereum - name: window in: query required: false description: >- Aggregation window. Which windows are valid depends on the asset — see the endpoint page. Defaults to `day`. schema: type: string enum: - block - 10min - hour - day default: day - name: from in: query required: false description: >- Inclusive start time, `YYYYMMDDTHHMMSS` (UTC). If `window=day`, `YYYYMMDD` is also accepted. schema: type: string - name: to in: query required: false description: >- Inclusive end time, `YYYYMMDDTHHMMSS` (UTC). If `window=day`, `YYYYMMDD` is also accepted. schema: type: string - name: limit in: query required: false description: Maximum rows returned (default 100, max 10000). schema: type: integer default: 100 maximum: 10000 - name: format in: query required: false description: 'Response format: `json` (default) or `csv`.' schema: type: string enum: - json - csv default: json responses: '200': description: Supply time-series. content: application/json: schema: type: object required: - status - result properties: status: $ref: '#/components/schemas/Status' result: type: object properties: window: type: string data: type: array items: type: object properties: datetime: type: string description: >- Interval start, `YYYY-MM-DD HH:MM:SS` (UTC). Present for every window. blockheight: type: integer description: >- Block height. Present only when `window` is `block`. supply_new: type: number description: >- The amount newly issued in the window. Native assets only (`eth`, `btc`) — issuance comes from block rewards. Returned for `btc`, `eth` assets only. supply_total: type: number description: The total amount of the asset in existence. supply_minted: type: number description: >- The amount minted in the window (an increase in total supply). Returned for `erc20`, `stablecoin` assets only. supply_burned: type: number description: >- The amount burned in the window (a decrease in total supply). Returned for `erc20`, `stablecoin` assets only. supply_circulating: type: number description: >- An approximation of the amount circulating in the market — total supply less balances held by the issuer (e.g. treasury addresses). Returned for `stablecoin` assets only. supply_issued: type: number description: >- The amount issued to clients in the window (an increase in circulating supply). Returned for `stablecoin` assets only. supply_redeemed: type: number description: >- The amount redeemed in the window (a decrease in circulating supply). Returned for `stablecoin` assets only. security: - AccessToken: [] x-codeSamples: - lang: Shell source: >- curl -X GET "https://api.cryptoquant.com/v2/network/supply?asset=eth&window=day" \ -H "Authorization: Bearer " - lang: JavaScript source: >- fetch("https://api.cryptoquant.com/v2/network/supply?asset=eth&window=day", { headers: { "Authorization": "Bearer "} }) .then(response => response.json()) .then(data => console.log(data)) - lang: NodeJS source: |- require('axios') .get("https://api.cryptoquant.com/v2/network/supply?asset=eth&window=day", { headers: { Authorization: 'Bearer ' } }) .then(response => console.log(response)) - lang: Ruby source: >- require 'net/http' uri = URI("https://api.cryptoquant.com/v2/network/supply?asset=eth&window=day") req = Net::HTTP::Get.new(uri) req["Authorization"] = "Bearer " res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) } puts res.body - lang: Python source: >- import requests headers = {'Authorization': 'Bearer '} url = "https://api.cryptoquant.com/v2/network/supply?asset=eth&window=day" print(requests.get(url, headers=headers).json()) components: schemas: Status: type: object description: >- Returned with every response; indicates whether the request was successful. required: - code - message properties: code: type: integer format: int32 description: HTTP status code. message: type: string description: Text description of the error or success. securitySchemes: AccessToken: type: http scheme: bearer bearerFormat: JWT description: >- For each API request, include the `Authorization` HTTP header with `Bearer {access_token}`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.