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

Show child attributes

💼 Past 24 Hour Trades by Token Address 💼 Top Token Holders by Token Address

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