the pnl leaderboard of top traders (fomo and pump.fun wallets), ranked like copy.top's discover page. window 1d, 7d or 30d; sort total (pnl), realized, roi, winrate or copiers; optional chain or platform (fomo, pumpfun); fair_play clean or clean_or_watch keeps only those.
- open without a key.
- REST: GET /v1/traders
- about 20 calls a minute without a key, 60 with a key.
- read-only.
parameters
| name | type | required | what it does |
|---|---|---|---|
| window | 1d | 7d | 30d | yes | - |
| sort | total | realized | roi | winrate | copiers | yes | - |
| chain | robinhood | solana | base | bnb | eth | arc | no | chain id as the tools give it |
| platform | fomo | pumpfun | no | - |
| fair_play | clean | clean_or_watch | no | - |
| limit | integer | no | default 10. from 1 to 20 |
call it over MCP
curl -s https://copy.top/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_leaderboard","arguments":{"window":"30d","sort":"realized","platform":"pumpfun","limit":10}}}'
the answer is in result.content[0].text, as a JSON string. an MCP client (Claude, Cursor, an agent framework) does this for you: ask in plain words and it picks the tool.
call it over REST
curl -s 'https://copy.top/v1/traders?window=30d&sort=realized&platform=pumpfun&limit=10'
example answer
a real answer from 2026-11-22, shortened: lists cut to two items.
{
"window": "30d",
"sort": "realized",
"traders": [
{
"handle": "pf_c311d04abf73",
"name": "supermandev",
"platforms": [
"pumpfun"
],
"pnl": 726823,
"realized": 726823,
"unrealized": 45457,
"roi": 10.609,
"winRate": 0.97,
"closed": 31,
"fairPlay": "flagged",
"badges": [
{
"label": "flipper",
"tone": "loss",
"detail": "97% of trades sold within 10 min"
}
],
"followers": 32537,
"copiers": 82,
"holdMin": 0,
"openN": 4,
"chains": [
"solana"
],
"url": "https://copy.top/t/pf_c311d04abf73?utm_source=mcp&utm_campaign=get_leaderboard&utm_term=rest.copytop-docs"
},
{
"handle": "pf_5ae8d0344ba0",
"name": "NateNateNateNat",
"platforms": [
"pumpfun"
],
"pnl": 372330,
"realized": 372330,
"unrealized": 0,
"roi": 1.035,
"winRate": 0.96,
"closed": 998,
"fairPlay": "flagged",
"badges": [
{
"label": "sells into copiers",
"tone": "loss",
"detail": "sold within 10 min of the first copier fill on 37% of copied tokens"
},
{
"label": "flipper",
"tone": "loss",
"detail": "100% of trades sold within 10 min"
}
],
"followers": 19364,
"copiers": 81,
"holdMin": 0,
"openN": 1,
"chains": [
"solana"
],
"url": "https://copy.top/t/pf_5ae8d0344ba0?utm_source=mcp&utm_campaign=get_leaderboard&utm_term=rest.copytop-docs"
}
]
}
copy.top