Top Token Traders by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network_id}/tokens/{token_address}/top_traders \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": {
    "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
    "type": "top_trader",
    "attributes": {
      "traders": [
        {
          "address": "9PHm2cYU8DhwBrbRsqqAjhW9uXVrNR1RaLsvo9oGVeaq",
          "name": null,
          "label": null,
          "type": null,
          "realized_pnl_usd": "31244842.94313992596882866680186718799091028666087696697895",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "0.107742029472092394285546782411629689178068069842295415369698476220071093",
          "average_sell_price_usd": "0.185768700769238679578034408599493144222248390198249281897411569987021326",
          "total_buy_count": 52433,
          "total_sell_count": 110413,
          "total_buy_token_amount": "270927018.63336",
          "total_sell_token_amount": "325324285.088228",
          "total_buy_usd": "29190226.8263815983907078691029715903175106331012100198765",
          "total_sell_usd": "60435069.76952152435953653590483877830842091976208698685545",
          "explorer_url": "https://solscan.io/account/9PHm2cYU8DhwBrbRsqqAjhW9uXVrNR1RaLsvo9oGVeaq"
        },
        {
          "address": "EmDewJpfQaxWqxthX1FUyBCCPNGt8Ac5ek4M4pnGTgxC",
          "name": null,
          "label": null,
          "type": null,
          "realized_pnl_usd": "15905876.28067880560869831706113433929706359106197218605713",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "0.184253360370337436869211178097415145516564034725531545632817230594310635",
          "average_sell_price_usd": "0.453961635984295417495686933363702788250069562233497749126971620666784823",
          "total_buy_count": 17794,
          "total_sell_count": 83977,
          "total_buy_token_amount": "17256482.108901",
          "total_sell_token_amount": "42041969.15458",
          "total_buy_usd": "3179564.81673561651094979626153080521112057472898785000329",
          "total_sell_usd": "19085441.09741442211964811332266514450818416579096003606042",
          "explorer_url": "https://solscan.io/account/EmDewJpfQaxWqxthX1FUyBCCPNGt8Ac5ek4M4pnGTgxC"
        }
      ]
    }
  }
}

GET

onchain

networks

{network_id}

tokens

{token_address}

top_traders

Top Token Traders by Token Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network_id}/tokens/{token_address}/top_traders \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": {
    "id": "solana_Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
    "type": "top_trader",
    "attributes": {
      "traders": [
        {
          "address": "9PHm2cYU8DhwBrbRsqqAjhW9uXVrNR1RaLsvo9oGVeaq",
          "name": null,
          "label": null,
          "type": null,
          "realized_pnl_usd": "31244842.94313992596882866680186718799091028666087696697895",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "0.107742029472092394285546782411629689178068069842295415369698476220071093",
          "average_sell_price_usd": "0.185768700769238679578034408599493144222248390198249281897411569987021326",
          "total_buy_count": 52433,
          "total_sell_count": 110413,
          "total_buy_token_amount": "270927018.63336",
          "total_sell_token_amount": "325324285.088228",
          "total_buy_usd": "29190226.8263815983907078691029715903175106331012100198765",
          "total_sell_usd": "60435069.76952152435953653590483877830842091976208698685545",
          "explorer_url": "https://solscan.io/account/9PHm2cYU8DhwBrbRsqqAjhW9uXVrNR1RaLsvo9oGVeaq"
        },
        {
          "address": "EmDewJpfQaxWqxthX1FUyBCCPNGt8Ac5ek4M4pnGTgxC",
          "name": null,
          "label": null,
          "type": null,
          "realized_pnl_usd": "15905876.28067880560869831706113433929706359106197218605713",
          "unrealized_pnl_usd": null,
          "token_balance": null,
          "average_buy_price_usd": "0.184253360370337436869211178097415145516564034725531545632817230594310635",
          "average_sell_price_usd": "0.453961635984295417495686933363702788250069562233497749126971620666784823",
          "total_buy_count": 17794,
          "total_sell_count": 83977,
          "total_buy_token_amount": "17256482.108901",
          "total_sell_token_amount": "42041969.15458",
          "total_buy_usd": "3179564.81673561651094979626153080521112057472898785000329",
          "total_sell_usd": "19085441.09741442211964811332266514450818416579096003606042",
          "explorer_url": "https://solscan.io/account/EmDewJpfQaxWqxthX1FUyBCCPNGt8Ac5ek4M4pnGTgxC"
        }
      ]
    }
  }
}

Notes

Top traders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
Only tokens created after 1 September 2023 are supported.
Stablecoins and wrapped native tokens (e.g. wSOL, wETH) are not supported.
Use the traders param to specify the number of top traders to retrieve (max 50).

SDK Examples

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

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

response = client.onchain.networks.tokens.top_traders.get(
  "Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump",
  network_id="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_id

string

default:solana

required

Network ID. *refers to /onchain/networks.

token_address

string

default:Dfh5DzRgSvvCFDoYc2ciTkMrbDfRKybA4SoFbPmApump

required

Token contract address.

Query Parameters

traders

string

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

sort

enum<string>

Sort the traders by field. Default: realized_pnl_usd_desc

Available options:

realized_pnl_usd_desc,

unrealized_pnl_usd_desc,

total_buy_usd_desc,

total_sell_usd_desc,

token_balance_desc

include_address_label

boolean

Include address label data. Default: false

Response

200 - application/json

Top token traders 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.traders

object[]

required

Hide child attributes

data.attributes.traders.address

string

required

Trader wallet address

data.attributes.traders.realized_pnl_usd

string

required

Realized PnL in USD

data.attributes.traders.unrealized_pnl_usd

string | null

required

Unrealized PnL in USD

data.attributes.traders.token_balance

string | null

required

Current token balance

data.attributes.traders.average_buy_price_usd

string

required

Average buy price in USD

data.attributes.traders.average_sell_price_usd

string

required

Average sell price in USD

data.attributes.traders.total_buy_count

integer

required

Total number of buy transactions

data.attributes.traders.total_sell_count

integer

required

Total number of sell transactions

data.attributes.traders.total_buy_token_amount

string

required

Total buy token amount

data.attributes.traders.total_sell_token_amount

string

required

Total sell token amount

data.attributes.traders.total_buy_usd

string

required

Total buy amount in USD

data.attributes.traders.total_sell_usd

string

required

Total sell amount in USD

data.attributes.traders.explorer_url

string

required

Block explorer URL for the trader address

data.attributes.traders.name

string | null

Address label name

data.attributes.traders.label

string | null

Address label

data.attributes.traders.type

string | null

Address type

CoinGecko API

Onchain API

Top Token Traders by Token Address

Notes

SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

​Notes

​SDK Examples

Authorizations

Path Parameters

Query Parameters

Response

Notes

SDK Examples