a hyperliquid trader by address: profile and metrics (win rate, profit factor, drawdown, usual leverage, score), pnl per window, open positions with entry, size, leverage and liquidation price, and latest fills.
- open without a key.
- REST: GET /v1/hyperliquid/traders/{address}
- a heavier read: about 6 calls a minute without a key, 30 with a key.
- read-only.
parameters
| name | type | required | what it does |
|---|---|---|---|
| address | string | yes | 0x + 40 hex |
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_trader","arguments":{"address":"0xADDRESS"}}}'
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/0xADDRESS'
example answer
a real answer from 2026-11-22, shortened: lists cut to two items.
{
"address": "0x15a4f009bb324a3fb9e36137136b201e3fe0dfdb",
"ranked": true,
"profile": {
"displayName": null,
"role": "user",
"masterAddress": null,
"accountValue": 37743641.261374,
"firstSeenAt": "2026-09-22T11:36:46.460Z",
"lastSeenAt": "2026-11-22T21:31:48.160Z",
"isActive": true,
"windows": [
{
"window": "30d",
"pnl": 12374417.873778,
"volume": 169023968.26,
"updatedAt": "2026-11-22T21:31:48.160Z"
},
{
"window": "all",
"pnl": 37306666.304575,
"volume": 1723044304.62,
"updatedAt": "2026-11-22T21:31:48.160Z"
}
],
"metrics": {
"fills": 943,
"trades": 46,
"tradesPerDay": 3.50731562174499,
"avgTradeUsd": 1827194.65284052,
"medianHoldMin": 1829.63928333333,
"takerRatio": 0.362672322375398,
"coreShare": 0.996171932987404,
"majorShare": 1,
"longShare": 0.294225447510558,
"topShare": 0.760351427092031,
"winRate": 0.58695652173913,
"winRateLong": 0.615384615384615,
"winRateShort": 0.575757575757576,
"profitFactor": 4.37349937695063,
"maxDd30dPct": 23.0543572610938,
"currentDdPct": 4.51896214577258,
"upShare30d": 0.545454545454545,
"calmar": 27.1112528629899,
"roi7d": 0.0640883174171734,
"roi30d": 0.520860424416017,
"inventoryShare": 0.237900085981424,
"avgTradeReturn": 0.00222168464789854,
"leverageUsual": 1.10509452123664,
"leveragePeak": 1.79964182572484,
"score": 46,
"scoreParts": {
"risk": 7,
"regularity": 16.4,
"performance": 13,
"copyability": 9.9,
"activity": 0,
"thin": false
},
"tags": [
"whale",
"swing"
],
"topCoins": [
{
"coin": "ETH",
"share": 0.6330822069245345
},
{
"coin": "BTC",
"share": 0.36308972606286927
}
],
"lastFillAt": "2026-11-05T07:08:51.203Z",
"enrichedAt": "2026-11-22T02:08:33.643Z"
}
},
"live": {
"accountValue": 28459214.485982,
"positions": [
{
"coin": "ETH",
"dex": "",
"size": -30000,
"entryPx": 2283.23,
"positionValue": 51591000,
"unrealizedPnl": 16905933.42649,
"leverage": 20,
"liquidationPx": 2912.7553830974
}
],
"fills": [
{
"coin": "ETH",
"dex": "",
"side": "A",
"dir": "Open Short",
"px": 2431.599772855,
"size": 2000,
"closedPnl": 0,
"time": 1793862531203
},
{
"coin": "ETH",
"dex": "",
"side": "A",
"dir": "Open Short",
"px": 2431.8106225267,
"size": 3000,
"closedPnl": 0,
"time": 1793862518311
}
],
"fillsTotal": 21,
"degraded": false
},
"fetchedAt": 1795384651045,
"url": "https://copy.top/t/hl/0x15a4f009bb324a3fb9e36137136b201e3fe0dfdb?utm_source=mcp&utm_campaign=hl_get_trader&utm_term=rest.copytop-docs"
}
copy.top