Whale Radar
Whale Radar surfaces large Polymarket fills from high-signal wallets. It is designed to show that meaningful flow is happening without leaking raw wallet identity to public or free clients.
What Qualifies#
A Whale Radar alert starts from a single large fill. The scanner checks whether the maker or taker wallet is currently represented on qualifying leaderboards such as Copyable Traders or Most Consistent, applies the wallet opt-out filter, enriches the fill with market metadata, and then stores the alert for serving, notifications, and tearsheet generation.
The alert describes the on-chain trade as a fact: market, side, direction, size, price, and time. Polyanna does not speculate about why a trader made a move.
Access Model#
- Anonymous and free users receive a delayed, capped feed with session-scoped labels such as Trader #47. The API does not send wallet addresses, transaction hashes, order hashes, usernames, or canonical image URLs in public payloads.
- Pro users receive the real-time feed with full trader identity, cursor history, filters, and configurable Telegram, email, or webhook alerts.
- API clients get the same tier-aware behavior as the owning account. Whale endpoints use private, no-store responses while labels can vary by session.
The frontend polls the tier-aware Whale API. It does not subscribe directly to raw database rows, because raw rows can contain wallet identity that public clients must never receive.
Showcase#
The Whale Radar page includes a curated historical showcase. The offline curator script can refresh automatic rows from alerts in the 7-day reveal window. When parquet price snapshots are available, the v1 curator ranks candidates by alert size multiplied by the positive side-adjusted price move around 72 hours after the alert. If that offline snapshot data is unavailable or no candidate prices can be matched, the full run falls back to alert size plus qualifying-leaderboard priority. Individual candidates missing a usable 72-hour price receive a neutral score, so incomplete data cannot outrank measured movers.
Showcase API responses stay wallet-safe for public clients. They are product proof and sharing material, not a raw identity dump.
Notifications#
Pro users configure Whale Radar notifications from Account Notifications. Filters include minimum USD size, category, direction, qualifying leaderboard, and specific wallets. Delivery uses the same Telegram, email, and webhook channels as trade alerts.