Top Token Traders by Token Address

To query top token traders based on the provided token contract address on a network

GET /onchain/networks/{network_id}/tokens/{token_address}/top_traders

Top Token Traders by Token Address

cURL

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>'

200

{
  "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

TypeScript

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

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

Authorizations

headerAuthqueryAuth

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

include_address_label · boolean

Include address label data. Default: false

Response

200 - application/json

Top token traders data

data · object · required

Show child attributes