# hl_get_trader

> hyperliquid trader: positions, pnl and fills

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

## related

- [hl_get_traders](https://copy.top/docs/tools/hl-get-traders.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-trader · 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.
