copy.top open the terminal
copy.top / docs / hl_get_traders

hl_get_traders

hyperliquid leaderboard api: top traders

this page in Markdown · llms.txt · openapi

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

nametyperequiredwhat it does
window24h | 7d | 30d | allyes-
sortpnl | roiyes-
limitintegernodefault 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

docs generated from the server's own tool definitions, version 0.2.2. copy.top is independent: it is 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.

copy the top.

see who wins, what they buy, and copy them from your own wallet.

find a trader