# create_alert_webhook

> alert webhooks: receive smart money alerts on your server

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

| name | type | required | what it does |
| --- | --- | --- | --- |
| url | string | yes | a public https url that answers 2xx within 5 seconds |
| 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 | - |

## 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

- [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/create-alert-webhook · 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.
