GET
/
networks
/
{network}
/
tokens
/
{address}
/
top_holders
๐Ÿ’ผ Top Token Holders by Token Address
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/tokens/{address}/top_holders \
  --header 'x-cg-pro-api-key: <api-key>'
{
  "data": {
    "id": "base_0x6921b130d297cc43754afba22e5eac0fbf8db75b",
    "type": "top_holder",
    "attributes": {
      "last_updated_at": "2025-03-26T09:15:26.926Z",
      "holders": [
        {
          "rank": 1,
          "address": "0xade9bcd4b968ee26bed102dd43a55f6a8c2416df",
          "label": "V3 Pool",
          "amount": "3841335481.0",
          "percentage": "5.6808",
          "value": "4898814.26"
        },
        {
          "rank": 2,
          "address": "0x1d9d215c477543d63cfc0be7b214ab94833d3df2",
          "label": null,
          "amount": "1901706692.0",
          "percentage": "2.8124",
          "value": "2425226.3"
        }
      ]
    }
  }
}

Note

  • The top holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
  • Supported chains include: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, and Ronin.
  • Max holders value:
    • Maximum 50 for non-Solana networks, 40 for Solana network.
  • ๐Ÿ’ผ Exclusive for Paid Plan subscribers (Analyst plan or above).
  • Cache/Update frequency: every 60 seconds.

Authorizations

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

Path Parameters

network
string
default:base
required

network ID *refers to /networks

Example:

"base"

address
string
default:0x6921b130d297cc43754afba22e5eac0fbf8db75b
required

token contract address

Example:

"0x6921b130d297cc43754afba22e5eac0fbf8db75b"

Query Parameters

holders
string
default:1

number of top token holders to return, you may use any integer or max Default value: 10

Response

200 - application/json

Get top token holders for a token

The response is of type object.