Skip to main content
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": "0x56bbe4200fdd412854bcf05f2c992827b64ee5c1",
          "label": null,
          "amount": "9703812154.0",
          "percentage": "14.3507",
          "value": "1016009.26",
          "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://basescan.org/address/0x56bbe4200fdd412854bcf05f2c992827b64ee5c1"
        },
        {
          "rank": 2,
          "address": "0x5e498b4edf68820b859650e8d02d5ede3e6c260e",
          "label": null,
          "amount": "9702318320.0",
          "percentage": "14.3485",
          "value": "1015852.85",
          "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://basescan.org/address/0x5e498b4edf68820b859650e8d02d5ede3e6c260e"
        }
      ]
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

​
include_pnl_details
boolean
default:false

include PnL details for token holders, default: false

Response

200 - application/json

Get top token holders for a token

​
data
object