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": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
    "type": "top_holder",
    "attributes": {
      "last_updated_at": "2026-05-28T03:21:51.545Z",
      "holders": [
        {
          "rank": 1,
          "address": "u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w",
          "label": "Wallet 1",
          "amount": "310021323.445634",
          "percentage": "31.0041",
          "value": "6157733.22",
          "average_buy_price_usd": null,
          "total_buy_count": null,
          "total_sell_count": null,
          "unrealized_pnl_usd": null,
          "unrealized_pnl_percentage": null,
          "realized_pnl_usd": null,
          "realized_pnl_percentage": null,
          "explorer_url": "https://solscan.io/account/u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w"
        },
        {
          "rank": 2,
          "address": "28RWPC6XPxSxUVjd27KiNRtcHVxKtd6cjms7eBcxiqdV",
          "label": null,
          "amount": "87536939.662678",
          "percentage": "8.7543",
          "value": "1738684.02",
          "average_buy_price_usd": null,
          "total_buy_count": null,
          "total_sell_count": null,
          "unrealized_pnl_usd": null,
          "unrealized_pnl_percentage": null,
          "realized_pnl_usd": null,
          "realized_pnl_percentage": null,
          "explorer_url": "https://solscan.io/account/28RWPC6XPxSxUVjd27KiNRtcHVxKtd6cjms7eBcxiqdV"
        }
      ]
    }
  }
}

GET

onchain

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": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
    "type": "top_holder",
    "attributes": {
      "last_updated_at": "2026-05-28T03:21:51.545Z",
      "holders": [
        {
          "rank": 1,
          "address": "u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w",
          "label": "Wallet 1",
          "amount": "310021323.445634",
          "percentage": "31.0041",
          "value": "6157733.22",
          "average_buy_price_usd": null,
          "total_buy_count": null,
          "total_sell_count": null,
          "unrealized_pnl_usd": null,
          "unrealized_pnl_percentage": null,
          "realized_pnl_usd": null,
          "realized_pnl_percentage": null,
          "explorer_url": "https://solscan.io/account/u6PJ8DtQuPFnfmwHbGFULQ4u4EgjDiyYKjVEsynXq2w"
        },
        {
          "rank": 2,
          "address": "28RWPC6XPxSxUVjd27KiNRtcHVxKtd6cjms7eBcxiqdV",
          "label": null,
          "amount": "87536939.662678",
          "percentage": "8.7543",
          "value": "1738684.02",
          "average_buy_price_usd": null,
          "total_buy_count": null,
          "total_sell_count": null,
          "unrealized_pnl_usd": null,
          "unrealized_pnl_percentage": null,
          "realized_pnl_usd": null,
          "realized_pnl_percentage": null,
          "explorer_url": "https://solscan.io/account/28RWPC6XPxSxUVjd27KiNRtcHVxKtd6cjms7eBcxiqdV"
        }
      ]
    }
  }
}

Notes

Top holders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
Max holders value: 50 for non-Solana networks, 40 for Solana.

Supported networks

Chain	Network `id`
Solana	`solana`
Ethereum	`eth`
Base	`base`
BNB Chain	`bsc`
Optimism	`optimism`
Arbitrum	`arbitrum`
Polygon	`polygon_pos`
TON	`ton`
Sui	`sui-network`
Robinhood	`robinhood`
Ronin	`ronin`
Bittensor	`bittensor`

SDK Examples

const response = await client.onchain.networks.tokens.topHolders.get('Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump', {
  network: 'solana',
});

console.log(JSON.stringify(response, null, 2));

response = client.onchain.networks.tokens.top_holders.get(
  "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
  network="solana",
)

print(response.model_dump_json(indent=2))

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:solana

required

Network ID. *refers to /onchain/networks.

address

string

default:Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump

required

Token contract address.

Query Parameters

holders

string

Number of top token holders to return, any integer or max. Default value: 10

include_pnl_details

boolean

Include PnL details for token holders. Default: false

Response

200 - application/json

Top token holders data

data

object

required

Show child attributes

💼 Top Token Traders by Token Address 💼 Historical Token Holders Chart by Token Address

CoinGecko API

Onchain API

Top Token Holders by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples