# get_leaderboard

> top traders pnl leaderboard: fomo and pump.fun

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"
    }
  ]
}
```

## related

- [search](https://copy.top/docs/tools/search.md)
- [get_trader](https://copy.top/docs/tools/get-trader.md)
- [get_token](https://copy.top/docs/tools/get-token.md)
- [get_theses](https://copy.top/docs/tools/get-theses.md)
- [get_hot_coins](https://copy.top/docs/tools/get-hot-coins.md)
- [get_live_trades](https://copy.top/docs/tools/get-live-trades.md)
- [all docs](https://copy.top/docs.md)

---
html: https://copy.top/docs/tools/get-leaderboard · all docs: https://copy.top/docs.md · copy.top is independent: not affiliated with fomo, pump.fun or Hyperliquid. the API is read-only: nothing here places an order. figures are data, not advice. trading crypto is risky and past performance does not predict results.
