---
title: "Coin Supply Breakdown by ID"
method: GET
path: "/coins/{id}/supply_breakdown"
---

# Coin Supply Breakdown by ID

`GET /coins/{id}/supply_breakdown`

## Request

- Base URL: `https://pro-api.coingecko.com/api/v3`
- URL: `https://pro-api.coingecko.com/api/v3/coins/{id}/supply_breakdown`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To query the supply breakdown of a coin based on provided coin ID

## Path parameters

- `id` string, required

## Response `200`

Coin supply breakdown data

- CoinSupplyBreakdown
  - `id` string, required: Coin ID
  - `symbol` string, required: Coin symbol
  - `name` string, required: Coin name
  - `supply_data` object, required: Supply data
    - `total_supply` number: Total supply
    - `circulating_supply` number: Circulating supply
    - `outstanding_supply` number: Outstanding supply
    - `non_circulating_supply` number: Non-circulating supply
    - `last_updated` string: Last updated timestamp in ISO 8601 format
  - `non_circulating_wallets` object[], required: List of non-circulating wallets
    - `address` string: Wallet address
    - `label` string: Wallet label
    - `balance` number: Wallet balance
    - `percentage_of_total_supply` number: Percentage of total supply held by this wallet
    - `anomaly` boolean: Indicates an unreliable balance update; when true, circulating supply falls back to the last known-good balance
    - `last_updated` string: Last updated timestamp in ISO 8601 format

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-api/revisions/dd263cff468b?raw)