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

Hide child attributes

data.id

string

required

Token identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.last_updated_at

string

required

Data last updated timestamp

data.attributes.holders

object[]

required

Hide child attributes

data.attributes.holders.rank

integer

required

Holder rank

data.attributes.holders.address

string

required

Holder wallet address

data.attributes.holders.label

string | null

required

Address label

data.attributes.holders.amount

string

required

Token amount held

data.attributes.holders.percentage

string

required

Percentage of total supply held

data.attributes.holders.value

string

required

Value of holdings in USD

data.attributes.holders.average_buy_price_usd

string | null

Average buy price in USD

data.attributes.holders.total_buy_count

integer | null

Total number of buy transactions

data.attributes.holders.total_sell_count

integer | null

Total number of sell transactions

data.attributes.holders.unrealized_pnl_usd

string | null

Unrealized PnL in USD

data.attributes.holders.unrealized_pnl_percentage

string | null

Unrealized PnL percentage

data.attributes.holders.realized_pnl_usd

string | null

Realized PnL in USD

data.attributes.holders.realized_pnl_percentage

string | null

Realized PnL percentage

data.attributes.holders.explorer_url

string

Block explorer URL for the holder 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