Currencies

Token Holders

Description

Top 100 token holders for a coin on a single network: address, label, type, balance, share of supply and USD value.

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

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

Tip: Resolve available networks for a coin via /currencies/{id}/contracts and network ids via /blockchains/map.

Access

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

Request

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

Path parameters

idinteger required
Example:1

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

Query parameters

pagenumber

Page number (1-based). Returns up to 100 items per page.

blockchainIdnumber
Example:1

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

excludeContractsboolean

Exclude contract addresses from the list. rank and percentOfSupply keep their original values — they are not recalculated over the filtered set.

sortOrder'asc' | 'desc'

Sort direction by rank. desc returns the same top holders starting from the lowest rank.

Response

Example response

{
  "data": [
    {
      "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
      "amount": "2517491523.184",
      "label": "Binance 8",
      "percentOfSupply": 3.4162,
      "rank": 1,
      "value": "2518123456.12"
    }
  ],
  "meta": {
    "blockchainId": 1,
    "hasNextPage": true,
    "page": 1,
    "pageSize": 25,
    "snapshotDate": "2026-09-04T01:09:29.181Z"
  },
  "status": {
    "timestamp": 1780000000000,
    "usedCredits": 1
  }
}

Changes

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