# get_alerts

> alerts when several top traders buy the same coin

events since a cursor, for alert bots: confluence (several top traders bought the same coin recently), big_trade (one tracked trader bought or sold a large amount) and thesis (a tracked trader posted a thesis). pass the cursor of the previous call as since; without since, the last 15 minutes. thresholds are yours.

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

## parameters

| name | type | required | what it does |
| --- | --- | --- | --- |
| since | string | no | the cursor of the previous call (iso time) |
| min_top_traders | integer | no | confluence threshold, default 3. from 1 to 50 |
| min_trade_usd | number | no | big trade threshold in dollars, default 5000 |
| max_mcap_usd | number | no | ignore coins above this market cap |
| kinds | array of confluence \| big_trade \| thesis | no | - |
| limit | integer | no | rows to return, default 40. ask for fewer to get a shorter answer. from 1 to 40 |

## 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_alerts","arguments":{"min_top_traders":3}}}'
```

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/alerts?min_top_traders=3'
```

## example answer

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

```
{
  "since": "2026-11-22T21:42:26.050Z",
  "cursor": "2026-11-22T21:57:26.050Z",
  "thresholds": {
    "min_top_traders": 3,
    "min_trade_usd": 5000,
    "max_mcap_usd": null
  },
  "events": [
    {
      "kind": "confluence",
      "at": "2026-11-22T21:56:10.926Z",
      "chain": "solana",
      "token": "5eiLc9r79PkJquiFvYWdXJYtGNRjTpzot8MR7Z4Ppump",
      "symbol": "Wojak",
      "topTraders": 10,
      "topStillIn": 5,
      "traders": 47,
      "mcap": 101619,
      "liquidityUsd": 23454,
      "change1h": 257,
      "boughtUsd": 17897,
      "soldUsd": 14282,
      "buyers": [
        "pf_e10182b4c9c7",
        "pf_57b96111f2a0"
      ],
      "buyerNames": [
        "pumpitloomdart",
        "Wintalt"
      ],
      "url": "https://copy.top/token/solana/5eiLc9r79PkJquiFvYWdXJYtGNRjTpzot8MR7Z4Ppump?utm_source=mcp&utm_campaign=get_alerts&utm_term=rest.copytop-docs"
    },
    {
      "kind": "confluence",
      "at": "2026-11-22T21:55:53.354Z",
      "chain": "solana",
      "token": "6FUsdyjaGrBoG8UNbpWwTp9qu6ehL3SCeHRc1fnepump",
      "symbol": "ER-100",
      "topTraders": 3,
      "topStillIn": 2,
      "traders": 13,
      "mcap": 27192,
      "liquidityUsd": null,
      "change1h": 1170,
      "boughtUsd": 3198,
      "soldUsd": 1357,
      "buyers": [
        "pf_ad963c589980",
        "pf_5dfd7bdf5a85"
      ],
      "buyerNames": [
        "prozacpwku",
        "lukie"
      ],
      "url": "https://copy.top/token/solana/6FUsdyjaGrBoG8UNbpWwTp9qu6ehL3SCeHRc1fnepump?utm_source=mcp&utm_campaign=get_alerts&utm_term=rest.copytop-docs"
    }
  ],
  "note": "pass cursor back as since on the next call. a coin can alert again when another top trader buys it."
}
```

## 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_theses](https://copy.top/docs/tools/get-theses.md)
- [get_hot_coins](https://copy.top/docs/tools/get-hot-coins.md)
- [all docs](https://copy.top/docs.md)

---
html: https://copy.top/docs/tools/get-alerts · 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.
