# search

> search crypto traders and coins by name, handle, ticker or address

find traders and coins on copy.top by name, handle, @x, $ticker or address. use it to resolve a name before the other tools.

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

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| query | string | yes | 2 to 80 characters |

## 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":"search","arguments":{"query":"sol"}}}'
```

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/search?query=sol'
```

## example answer

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

```
{
  "traders": [
    {
      "handle": "pf_53013d145c49",
      "name": "solpropp",
      "platforms": [
        "pumpfun"
      ]
    },
    {
      "handle": "pf_38b3910dd662",
      "name": "batsol",
      "platforms": [
        "pumpfun"
      ]
    }
  ],
  "coins": [
    {
      "chain": "solana",
      "address": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "name": "Solana",
      "mcap": 41564211216,
      "change1h": 0.5,
      "change24h": 0.1
    },
    {
      "chain": "bnb",
      "address": "0x570a5d26f7765ecb712c0924e4de545b89fd43df",
      "symbol": "SOL",
      "name": "SOLANA",
      "mcap": 105663695,
      "change1h": 0.3,
      "change24h": -0.1
    }
  ]
}
```

## related

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