# get_theses

> trade theses posted by tracked traders

the latest or most popular theses (a trader's written reason for holding a coin) posted by tracked traders in the last 24 h at most, with the coin and their pnl at post.

- open without a key.
- REST: GET /v1/theses
- about 20 calls a minute without a key, 60 with a key.
- read-only.

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| sort | new \| popular | yes | - |
| hours | integer | no | default 24. from 1 to 24 |
| limit | integer | no | rows to return, default 10. ask for fewer to get a shorter answer. from 1 to 10 |

## 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_theses","arguments":{"sort":"new","limit":5}}}'
```

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/theses?sort=new&limit=5'
```

## example answer

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

```
{
  "theses": [
    {
      "id": "t2-b7bc1a8710e582a26eda66017cda38e4de8d9f011bb8a75a3a54def153cb3241-c5fde3f5",
      "handle": "heat",
      "name": "heat",
      "chain": "solana",
      "token": "ANt31zPFtdqb327BxLcvPnSUSTMzm5Rf7xfKN5kbpump",
      "symbol": "Mikol",
      "text": "(the trader's own text)",
      "at": "2026-11-22T21:45:50.000Z",
      "atPostPct": 78.5,
      "sinceUsd": null,
      "sinceRet": null,
      "entryMcap": null,
      "mcap": 20717,
      "platform": "fomo"
    },
    {
      "id": "t2-e9c66fc9dbffca52a711bbd6fbeae9dd802390e50ed75f4718238df503481331-6fe02f44",
      "handle": "Jeff___86",
      "name": "MetaJeff_86 🇧🇪 |",
      "chain": "solana",
      "token": "6d9fD5SxvN4DAG4SHQD8pebm8TM6XeSbYezPDjdapump",
      "symbol": "PINO",
      "text": "(the trader's own text)",
      "at": "2026-11-22T21:45:40.000Z",
      "atPostPct": 274.7,
      "sinceUsd": null,
      "sinceRet": null,
      "entryMcap": 173106,
      "mcap": 533581,
      "platform": "fomo"
    }
  ]
}
```

## 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_token](https://copy.top/docs/tools/get-token.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-theses · 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.
