---
title: "Supply"
method: GET
path: "/stablecoin/network-data/supply"
tags: ["Stablecoin Network Data"]
---

# Supply

`GET /stablecoin/network-data/supply`

This endpoint returns metrics related to token supply, i.e. the amount of tokens in existence. We currently provide six metrics. supply_total is the total amount of tokens in existence, and supply_circulating is an approximation of the amount of tokens that are circulating in the market(e.g. excluding tokens owned by the issuing company's treasury address). supply_minted and supply_burned represents how many tokens were added/subtracted from supply_total. supply_issued and supply_redeemed represents how many tokens were added/subtracted from supply_circulating. For some tokens, mint and issue(or redeem and burn) occurs simultaneously, and for others this does not. For further information, please refer to the section 'Stablecoin Issuing Mechanism'.

**📖 Data Guide:** [Stablecoin Network Data](/data-guide/stablecoin/stablecoin-network-data) — definition, interpretation, and chart examples.

## Query parameters

- `token` string, required
- `window` string
- `from` string
- `to` string
- `limit` integer
- `format` string

## Response `200`

supply_total, supply_minted, supply_burned, supply_circulating, supply_issued, supply_redeemed

- object
  - `status` object, required — The status object is return with most of requests and indicates if the request was successful. If it is not successful, error information is included.
    - `code` integer, required — HTTP status code
    - `message` string, required — Text description of the error or success.
  - `result` object, required
    - `window` string, required — The size of window. It can be day or block, and it depends on the user request.
    - `data` object[], required
      - `datetime` string — The date and time formatted as YYYY-MM-DD HH:MM:SS (UTC time). This field only appears when window=block is used.
      - `blockheight` string — The height of the block. This optional field only appears when window=block is used.
      - `date` string — The date in YYYY-DD-MM. This optional field only appears when window=day is used.
      - `supply_total` number, required — The total amount of BTC in existence.
      - `supply_minted` number, required — The amount of tokens minted (increase in total supply).
      - `supply_burned` number, required — The amount of tokens burned (decrease in total supply).
      - `supply_circulating` number, required — The approximation of the amount of tokens that are circulating in the market.
      - `supply_issued` number, required — The amount of tokens issued (increase in circulating supply).
      - `supply_redeemed` number, required — The amount of tokens redeemed (decrease in circulating supply).

---

[API](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api.md) · [All operations](https://skmtc.net/cryptoquant/apis/cryptoquant-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cryptoquant/cryptoquant-data-api/revisions/81ee223d4908/schema)