# hl_get_traders

> hyperliquid leaderboard api: top traders

rank hyperliquid perps traders tracked by copy.top. window 24h, 7d, 30d or all; sort pnl or roi. each row: address, name, account value, pnl, roi, volume, win rate, style, trades per day, max drawdown 30d, top coins.

- open without a key.
- REST: GET /v1/hyperliquid/traders
- about 20 calls a minute without a key, 60 with a key.
- read-only.

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| window | 24h \| 7d \| 30d \| all | yes | - |
| sort | pnl \| roi | yes | - |
| 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":"hl_get_traders","arguments":{"window":"30d","sort":"pnl","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/hyperliquid/traders?window=30d&sort=pnl&limit=10'
```

## example answer

a real answer from 2026-11-22, shortened: lists cut to two items.

```
{
  "window": "30d",
  "sort": "pnl",
  "total": 608,
  "updatedAt": "2026-11-22T21:31:48.160Z",
  "traders": [
    {
      "address": "0x15a4f009bb324a3fb9e36137136b201e3fe0dfdb",
      "masterAddress": null,
      "displayName": null,
      "accountValue": 37743641.261374,
      "pnl": 12374417.873778,
      "roi": 0.520860424416017,
      "volume": 169023968.26,
      "updatedAt": "2026-11-22T21:31:48.160Z",
      "tradesPerDay": 3.50731562174499,
      "avgTradeUsd": 1827194.65284052,
      "medianHoldMin": 1829.63928333333,
      "takerRatio": 0.362672322375398,
      "coreShare": 0.996171932987404,
      "maxDd30dPct": 23.0543572610938,
      "topCoins": [
        {
          "coin": "ETH",
          "share": 0.6330822069245345
        },
        {
          "coin": "BTC",
          "share": 0.36308972606286927
        }
      ],
      "score": 46,
      "tags": [
        "whale",
        "swing"
      ],
      "winRate": 0.58695652173913,
      "style": "swing"
    },
    {
      "address": "0x0c1fd4fed8679488afb3b23b2b872971e0001d39",
      "masterAddress": "0x0b8aa35c28b7c6ab18f11dc168f437a8a69fd4f8",
      "displayName": null,
      "accountValue": 2057497.479319,
      "pnl": 3015668.788621,
      "roi": 1.192553561354,
      "volume": 120751457.03,
      "updatedAt": "2026-11-22T14:56:11.856Z",
      "tradesPerDay": 955.392508166906,
      "avgTradeUsd": 3226.52431273176,
      "medianHoldMin": 770.226661706543,
      "takerRatio": 1,
      "coreShare": 1,
      "maxDd30dPct": 12.3376047870764,
      "topCoins": [
        {
          "coin": "BTC",
          "share": 0.39460703084150245
        },
        {
          "coin": "ZEC",
          "share": 0.24215937573037502
        }
      ],
      "score": 40,
      "tags": [
        "whale",
        "day"
      ],
      "winRate": null,
      "style": "swing"
    }
  ]
}
```

## related

- [hl_get_trader](https://copy.top/docs/tools/hl-get-trader.md)
- [hl_get_markets](https://copy.top/docs/tools/hl-get-markets.md)
- [hl_get_market_read](https://copy.top/docs/tools/hl-get-market-read.md)
- [hl_get_calls](https://copy.top/docs/tools/hl-get-calls.md)
- [all docs](https://copy.top/docs.md)

---
html: https://copy.top/docs/tools/hl-get-traders · 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.
