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

create_alert_webhook

alert webhooks: receive smart money alerts on your server

this page in Markdown · llms.txt · openapi

push alerts to your server: copy.top will POST new events (confluence, big_trade, thesis) to an https url, checked once a minute, with your thresholds. returns a signing secret, shown once. needs an api key. up to 3 webhooks per key.

  • needs a free api key (Authorization: Bearer YOUR_KEY).
  • MCP only (no REST route).
  • about 20 calls a minute without a key, 60 with a key.
  • changes something on your account (your webhooks only).

parameters

nametyperequiredwhat it does
urlstringyesa public https url that answers 2xx within 5 seconds
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-

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":"create_alert_webhook","arguments":{"url":"https://your-server.example/copytop","min_top_traders":3,"kinds":["confluence"]}}}'

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.

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