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

get_alerts

alerts when several top traders buy the same coin

this page in Markdown · llms.txt · openapi

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

nametyperequiredwhat it does
sincestringnothe cursor of the previous call (iso time)
min_top_tradersintegernoconfluence threshold, default 3. from 1 to 50
min_trade_usdnumbernobig trade threshold in dollars, default 5000
max_mcap_usdnumbernoignore coins above this market cap
kindsarray of confluence | big_trade | thesisno-
limitintegernorows 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

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