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

alerts

get alerts when several top traders buy the same coin, on a big trade, or on a new thesis: poll get_alerts with a cursor, or receive signed webhooks.

this page in Markdown · llms.txt · openapi

three kinds of events: 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). the thresholds are yours.

by polling (no key)

curl -s 'https://copy.top/v1/alerts?min_top_traders=3'

keep the cursor the answer returns and pass it back as since on the next call. once a minute is enough. without since, you get the last 15 minutes.

by webhook (free key)

create_alert_webhook registers an https address; copy.top checks for new events once a minute and POSTs them to it. up to 3 webhooks per key. the signing secret is returned once.

POST https://your-server.example/copytop
content-type: application/json
x-copytop-signature: sha256=<hex hmac-sha256(secret, raw body)>
x-copytop-webhook-id: 42

{ "type": "copytop.alerts", "webhook_id": 42, "sent_at": "2026-11-22T20:00:00.000Z", "events": [ ... ] }

check the signature on the raw body before you trust it, and answer 2xx within 5 seconds. a webhook that keeps failing is turned off; list_alert_webhooks shows its last error.

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