# get_token

> a coin and which top traders hold it

a coin's copy.top page: price, market cap, 1h and 24h moves, liquidity, which tracked traders hold it or sold it and their pnl on it, and their theses.

- open without a key.
- REST: GET /v1/coins/{chain}/{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 |
| --- | --- | --- | --- |
| chain | robinhood \| solana \| base \| bnb \| eth \| arc | yes | chain id as the tools give it |
| address | string | yes | - |

## 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_token","arguments":{"chain":"solana","address":"So11111111111111111111111111111111111111112"}}}'
```

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/coins/solana/So11111111111111111111111111111111111111112'
```

## example answer

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

```
{
  "token": {
    "symbol": "SOL",
    "name": "Wrapped SOL",
    "price": 70.32,
    "mcap": null,
    "liquidityUsd": 16852610,
    "change1h": 0.5,
    "change24h": null,
    "ageDays": 1242,
    "dead": false
  },
  "leaders": {
    "holdingNow": 0,
    "soldOut": 0,
    "rows": []
  },
  "theses": [
    {
      "id": "t2-54604284b7c363bad738dcd5f425a2aadab91678e149649b090aa37bd280b939-44999fdb",
      "handle": "0xsneakky",
      "name": null,
      "chain": "solana",
      "token": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "text": "(the trader's own text)",
      "at": "2026-11-13T18:31:25.000Z",
      "atPostPct": -8.1,
      "sinceUsd": null,
      "sinceRet": null,
      "entryMcap": null,
      "mcap": null,
      "platform": "fomo"
    },
    {
      "id": "t2-0f9b9ea699d7fa132b647ade82a7ddab6b9d1d653bbb3f6dc61a5162bdc3877c-598aab65",
      "handle": "awtorkowski7",
      "name": null,
      "chain": "solana",
      "token": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "text": "(the trader's own text)",
      "at": "2026-11-12T02:00:45.000Z",
      "atPostPct": -16.8,
      "sinceUsd": null,
      "sinceRet": null,
      "entryMcap": null,
      "mcap": null,
      "platform": "fomo"
    }
  ],
  "thesesTotal": 15,
  "copiersHolding": 3,
  "chain": "solana",
  "address": "So11111111111111111111111111111111111111112",
  "url": "https://copy.top/token/solana/So11111111111111111111111111111111111111112?utm_source=mcp&utm_campaign=get_token&utm_term=rest.copytop-docs"
}
```

## related

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