Skip to main content
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.
  • Supported chains: Solana, EVM (Ethereum, Polygon, BNB, Arbitrum, Optimism, Base), Sui, TON, Ronin.
  • Max holders value: 50 for non-Solana networks, 40 for Solana.

​
SDK Examples

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

console.log(JSON.stringify(response, null, 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