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

get_trader

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

this page in Markdown · llms.txt · openapi

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

nametyperequiredwhat it does
handlestringyesthe 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

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