Trade Alerts

Get notified when traders on your watchlist make moves. Trade alerts are a Pro feature powered by newly indexed Polygon filled orders.

How It Works#

When live ingestion is active, Polyanna indexes on-chain filled orders within roughly 60 seconds of execution. The alert scanner checks these filled orders against your watchlist every 10 seconds. When a match is found, you get an alert on your enabled channels with the trade details: trader, market, direction, size, and price.

Alert Channels#

Configure Telegram and webhook delivery from Account → Alerts. CLI alert delivery is configured from the terminal with polyanna alert.

Telegram#

The fastest channel. Click "Connect Telegram" in your account settings to generate a link that opens @PolyannaAlertBot in Telegram. Once connected, alerts arrive as formatted messages with trader profile links. Use /stop in the bot chat to disconnect at any time.

Webhook#

Push alert payloads to your own HTTP endpoint. Useful for custom bots, Discord integrations, or automated trading pipelines. Payloads are JSON with full trade details. Optionally configure an HMAC-SHA256 signing secret — when set, every request includes an X-Polyanna-Signature header you can verify to confirm authenticity.

CLI#

Use the Polyanna CLI to add traders manually or from leaderboards to your watchlist and stream alerts from your shell. polyanna alert watch prints alerts continuously, and polyanna alert watch --raw --format ndjson emits pipe-friendly events for scripts.

Smart Batching#

High-frequency traders (bots, market makers) can execute dozens of trades in minutes. Instead of spamming you with individual alerts, Polyanna batches rapid activity automatically. If a trader makes 5 or more trades within a short window, you receive a single summary alert showing: total trades, total USD volume, net direction, time span, and markets involved.

Filters#

Each watchlisted trader has its own alert settings on the watchlist page. You can set a custom minimum USD amount, direction filter, and a label that appears in alerts instead of the raw address.

Whale Radar Alerts#

Pro users can also configure Whale Radar alerts from Account → Alerts. Whale Radar uses the same saved Telegram and webhook alert connections, with separate filters for minimum size, category, direction, qualifying label, and specific wallets. The underlying Whale Radar feed and redaction model are documented in Whale Radar.

Test Alerts#

Each channel has a "Test" button in the alert settings. Use it to verify your configuration is working before waiting for a real trade. Test alerts send a sample alert through the selected channel.

Alert History#

Your watchlist page includes an alert history section showing recently dispatched alerts with delivery status, channel, trader, and timestamp. Use this to verify alerts are being delivered and review recent activity.