Trade Alerts

Get notified in real time when traders on your watchlist make moves. Trade alerts are a Pro feature.

How It Works#

Polyanna's collector ingests on-chain fill events within roughly 60 seconds of execution. The alert scanner checks these fills against your watchlist every 10 seconds. When a match is found, you get a notification on your enabled channels with the trade details: trader, market, direction, size, and price.

Notification Channels#

Configure any combination of three channels from Account → Notifications:

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.

Email#

Receive alert emails at any address you configure. Each email includes the trade details and a link to the trader's profile on Polyanna. You can also enable a daily digest that summarizes the previous 24 hours of alerts into a single email at a time you choose (UTC).

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.

Smart Batching#

High-frequency traders (bots, market makers) can execute dozens of trades in minutes. Instead of spamming you with individual notifications, 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 notifications instead of the raw address.

Daily Digest#

Enable the daily digest to receive a once-a-day email summarizing all alerts from the past 24 hours, grouped by trader. Choose the hour (UTC) that works best for you. The digest uses the email address saved in your notification settings above, not your account sign-in email, and it requires at least one live alert channel to stay enabled.

Test Alerts#

Each channel has a "Test" button in the notification settings. Use it to verify your configuration is working before waiting for a real trade. Test alerts send a sample notification through the selected channel. Email tests may land in spam or promotions depending on the receiving mailbox.

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.