Skip to main content
GET
/
coins
/
{id}
/
supply_breakdown
💼 Coin Supply Breakdown by ID
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/coins/{id}/supply_breakdown \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "id": "uniswap",
  "symbol": "uni",
  "name": "Uniswap",
  "supply_data": {
    "total_supply": 894488420.0329479,
    "circulating_supply": 622353561.5538775,
    "outstanding_supply": 0,
    "non_circulating_supply": 272134858.4790704,
    "last_updated": "2026-06-11T09:16:07.477Z"
  },
  "non_circulating_wallets": [
    {
      "address": "0x1a9C8182C09F50C8318d769245beA52c32BE35BC",
      "label": "UNI Timelock",
      "balance": 272134858.4790704,
      "percentage_of_total_supply": 30.423383405422996,
      "anomaly": false,
      "last_updated": "2026-06-11T06:14:14.076Z"
    }
  ]
}

Tips

  • You may obtain the coin ID (API ID) via several ways:
    • Refer to respective coin page and find ‘API ID’.
    • Refer to /coins/list endpoint.
    • Refer to Google Sheets here.
  • You may use the has_supply_breakdown field from /coins/{id} endpoint to check if a coin has supply breakdown data available.
  • The anomaly flag indicates unreliable balance data (e.g., >50% drops, fetch errors, unsupported chains) that has been excluded from circulating supply calculations, preserving the last known-good balance until manually reviewed.

Note

  • Exclusive for Analyst, Lite, Pro and Enterprise plan subscribers.

Authorizations

x-cg-pro-api-key
string
header
required

Path Parameters

id
string
required

coin ID *refers to /coins/list.

Response

200 - application/json

Get coin supply breakdown

id
string

coin ID

symbol
string

coin symbol

name
string

coin name

supply_data
object
non_circulating_wallets
object[]

list of non-circulating wallets