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