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"
}
]
}
copy.top