Skip to main content
GET
/
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": "base_0x6921b130d297cc43754afba22e5eac0fbf8db75b",
    "type": "top_trader",
    "attributes": {
      "traders": [
        {
          "address": "0xf748879edbe8cca140940788163d7be4d2a2e46a",
          "name": "@zimagetsfox",
          "label": "zimagetsfox.eth",
          "type": "other",
          "realized_pnl_usd": "1157358.77",
          "unrealized_pnl_usd": "255071.37",
          "token_balance": "1454984.43",
          "average_buy_price_usd": "0.01144",
          "average_sell_price_usd": "0.03460",
          "total_buy_count": 48,
          "total_sell_count": 109,
          "total_buy_token_amount": "51422264.86",
          "total_sell_token_amount": "49967280.42",
          "total_buy_usd": "588308.47",
          "total_sell_usd": "1729021.16",
          "explorer_url": "https://etherscan.io/address/0xf748879edbe8cca140940788163d7be4d2a2e46a"
        }
      ]
    }
  }
}

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 traders data is currently in Beta, with ongoing improvements to data quality, coverage, and update frequency.
  • Only tokens created after 1st September 2023 are supported for top traders data.
  • Stablecoins and wrapped native tokens (e.g. wSOL, wETH) are not supported for this endpoint.
  • You may specify the number of top traders to retrieve using the traders query parameter with a maximum value of 50.
  • 💼 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_id
string
default:base
required

network ID *refers to /networks

Example:

"base"

​
token_address
string
default:0x6921b130d297cc43754afba22e5eac0fbf8db75b
required

token contract address

Example:

"0x6921b130d297cc43754afba22e5eac0fbf8db75b"

Query Parameters

​
traders
string
default:10

number of top token traders to return, you may use any integer or max Default value: 10

​
sort
enum<string>
default:realized_pnl_usd_desc

sort the traders by field Default value: 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
default:false

include address label data, default: false

Response

200 - application/json

Get top token traders for a token

​
data
object