# get_trader

> wallet pnl of a crypto trader: win rate, positions and recent trades

a trader's copy.top profile, like a wallet tracker (fomo or pump.fun): pnl 30d (realized, unrealized, total), roi, win rate, fair play verdict and badges, followers, copiers, platforms, largest open positions, latest trades and theses.

- open without a key.
- REST: GET /v1/traders/{handle}
- a heavier read: about 6 calls a minute without a key, 30 with a key.
- read-only.

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| handle | string | yes | the trader's handle, as search or another tool gave it |

## 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":"get_trader","arguments":{"handle":"HANDLE"}}}'
```

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/traders/HANDLE'
```

## example answer

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

```
{
  "as_of": "2026-11-22T21:59:18.948Z",
  "trader": {
    "handle": "pf_c311d04abf73",
    "name": "supermandev",
    "platforms": [
      "pumpfun"
    ],
    "pnl": 726823,
    "realized": 726823,
    "unrealized": 27900,
    "roi": 10.609,
    "winRate": 0.97,
    "closed": 31,
    "fairPlay": "flagged",
    "badges": [
      {
        "label": "flipper",
        "tone": "loss",
        "detail": "97% of trades sold within 10 min"
      }
    ],
    "followers": 32537,
    "copiers": 82,
    "holdMin": null,
    "openN": 4,
    "chains": [
      "solana"
    ],
    "url": "https://copy.top/t/pf_c311d04abf73?utm_source=mcp&utm_campaign=get_trader&utm_term=rest.copytop-docs"
  },
  "open_positions": [
    {
      "chain": "solana",
      "token": "3D8KYFmgArNze4obWakfwPLDjvkoiabpXVBRCyL5GqHm",
      "symbol": "Murad",
      "valueUsd": 32254,
      "pnlUsd": 18413,
      "ret": 1.33,
      "openedAt": "2026-09-04T22:51:26.000Z"
    },
    {
      "chain": "solana",
      "token": "7PEax6S9oJFew6qMpz1iXbSDtUczroisLEycBBW9pump",
      "symbol": "LACY",
      "valueUsd": 14542,
      "pnlUsd": 4280,
      "ret": 0.417,
      "openedAt": "2026-10-05T21:52:28.000Z"
    }
  ],
  "latest_trades": [
    {
      "at": "2026-11-20T18:56:27.913Z",
      "side": "sell",
      "chain": "solana",
      "token": "4wtXDDQ9tkRSnsaS3w88FAkJwAtnCrfNKGkFXgNNpump",
      "symbol": "4wtXDDQ9",
      "usd": 204,
      "mcap": null
    },
    {
      "at": "2026-11-20T18:56:27.572Z",
      "side": "sell",
      "chain": "solana",
      "token": "4wtXDDQ9tkRSnsaS3w88FAkJwAtnCrfNKGkFXgNNpump",
      "symbol": "4wtXDDQ9",
      "usd": 221,
      "mcap": null
    }
  ],
  "theses": [
    {
      "id": "pumpfun:9077d0ff-894c-4c8d-a791-18d08e7eee4d",
      "handle": "pf_c311d04abf73",
      "name": null,
      "chain": "solana",
      "token": "Fgmy6MpdrH8jjJ9i8RY53PVVdFdKLz6JX34tHJvcpump",
      "symbol": null,
      "text": "(the trader's own text)",
      "at": "2026-10-31T21:04:37.972Z",
      "atPostPct": -34.6,
      "sinceUsd": null,
      "sinceRet": null,
      "entryMcap": 51834,
      "mcap": null,
      "platform": "pumpfun"
    },
    {
      "id": "pumpfun:70624fad-f5b2-4156-b9e0-8044e1d520dd",
      "handle": "pf_c311d04abf73",
      "name": null,
      "chain": "solana",
      "token": "DxVRhH3XiXAaCmDW5mayGhGovTUZZegrTZEApCZHpump",
      "symbol": "ALON",
      "text": "(the trader's own text)",
      "at": "2026-10-21T01:15:46.859Z",
      "atPostPct": -83.3,
      "sinceUsd": null,
      "sinceRet": null,
      "entryMcap": 413347,
      "mcap": 34308,
      "platform": "pumpfun"
    }
  ]
}
```

## related

- [search](https://copy.top/docs/tools/search.md)
- [get_leaderboard](https://copy.top/docs/tools/get-leaderboard.md)
- [get_token](https://copy.top/docs/tools/get-token.md)
- [get_theses](https://copy.top/docs/tools/get-theses.md)
- [get_hot_coins](https://copy.top/docs/tools/get-hot-coins.md)
- [get_live_trades](https://copy.top/docs/tools/get-live-trades.md)
- [all docs](https://copy.top/docs.md)

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