Currencies

Token Holders Summary

Description

Ownership aggregates for a coin on a single network: total holders, top-100 share, wallet vs contract split, concentration by rank and holder tier distribution.

Note: Coverage is limited to the top-1000 coins by market cap and EVM networks only. Coins outside coverage return null metrics, not an error.

Note: All metrics are per-network and are never summed across networks. Data is a daily snapshot; snapshotDate returns its collection time.

Tip: For the holder rows behind these aggregates use /currencies/{id}/holders.

Access

  • Available from: Advanced
  • Cost: 1 credit per request
get/v3/currencies/{id}/holders/summary

Request

  • Base URL: https://api.cryptorank.io
  • URL: https://api.cryptorank.io/v3/currencies/{id}/holders/summary
  • Auth: API key in header X-Api-Key

Path parameters

idinteger required
Example:1

Coin ID. See: GET /v3/currencies/map.

Query parameters

blockchainIdnumber
Example:1

Network to return aggregates for. Defaults to the coin's primary network — the one the website opens first. Unknown id → 400. See: GET /v3/blockchains/map.

Response

Example response

{
  "data": {
    "blockchainId": 1,
    "concentration": [
      {
        "amount": "12587457615.92",
        "bucket": "top1_5",
        "percentOfSupply": 17.08,
        "value": "12591234567.12"
      }
    ],
    "contractsShare": 58.8,
    "holdersCount": 4213567,
    "snapshotDate": "2026-09-04T01:09:29.181Z",
    "tierDistribution": [
      {
        "holdersCount": 1200,
        "holdersPercent": 0.03,
        "tier": "whale"
      }
    ],
    "top100Share": 63.41,
    "totalSupply": "73692183812.24",
    "walletsShare": 41.2
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.