PolyWhale — Polymarket Whale Tracker

Real-time whale trade monitoring and smart money analysis for Polymarket

You're watching a Polymarket event. The odds shift 5% in thirty seconds. You have no idea why. Someone just dropped $40,000 on one side. A trader with a track record of calling elections, crypto moves, and geopolitical events just made a big bet — and you didn't see it happen. By the time you notice the price change, the edge is gone. On Polymarket, the biggest trades move markets. Knowing who is betting what — and how much — is the difference between reacting and anticipating. WHY TRACKING WHALE TRADES IS SO HARD Polymarket doesn't surface large trades in the UI. Every $50 bet looks the same as a $50,000 one. There's no trade feed, no size filter, no alert system. - Trades scroll past in real time with no size distinction - There's no way to filter by dollar amount on the platform - You can't see who the top holders are on any given market - Price moves happen before you can figure out what caused them - Manually checking trade history across markets is impractical Most traders either miss whale activity entirely or spend hours manually refreshing API endpoints. Neither approach scales. PolyWhale exists to solve this. It watches every trade, calculates real dollar values using live market prices, and surfaces only the ones that matter. WHAT THIS EXTENSION DOES PolyWhale is a Chrome Side Panel extension that monitors Polymarket trades in real time and alerts you when large positions are taken. It also injects a Smart Money analysis panel directly onto Polymarket event pages, showing you who holds the biggest positions on each side of a market. No spreadsheets. No API keys. No backend server. Everything runs locally in your browser. Here's what you get: Whale Trade Feed — A real-time waterfall of large trades displayed in the Chrome Side Panel. Every trade shows the market name, dollar amount, direction (BUY or SELL), outcome (Yes or No), trader pseudonym, and how long ago it happened. Click any trade to jump straight to that market on Polymarket. Custom Threshold — Set your own minimum dollar amount to define what counts as a "whale" trade. Preset buttons for $100, $1K, $5K, $10K, and $50K, or type any custom value. Only trades above your threshold appear in the feed. Batch Price Engine — Every polling cycle, PolyWhale collects all active token IDs and fetches real-time prices in a single batch request. Trade dollar values are calculated by multiplying the number of shares by the current market price — not the stale price attached to the original trade record. Smart Money Overlay — When you visit any Polymarket event page, a floating panel appears showing the top holders for both the Yes and No sides. You see each holder's pseudonym, their position size in dollars, and the total capital on each side. A "Smart Money Verdict" tells you which direction the concentrated capital is leaning, with a percentage breakdown. Desktop Notifications — Get a browser notification when a whale trade is detected. Choose between real-time alerts, hourly digests, or every 4 hours. Each notification shows the trade direction, dollar amount, and market name. Click the notification to open that market directly. Today Filter — Toggle between all cached trades or just today's activity with a single tap. HOW IT WORKS 1. Install the extension and set your whale threshold during the one-time setup 2. PolyWhale begins polling Polymarket trades in the background every 60 seconds 3. Open the Side Panel to see the live whale feed — polling speeds up to every 15 seconds while the panel is visible 4. Visit any Polymarket event page to see the Smart Money panel with top holder analysis 5. Receive desktop notifications when trades above your threshold are detected That's it. No account needed. No configuration files. It starts working the moment you install it. WHY A SIDE PANEL INSTEAD OF A POPUP Popups close the moment you click anywhere else. For a live trade feed, that's useless — you'd lose your place every time you interact with the page. The Side Panel stays open alongside your browser. You can watch the whale feed while browsing Polymarket, reading news, or doing research. The feed updates automatically without you needing to reopen anything. When the Side Panel is visible, polling runs every 15 seconds. When you close it, polling drops to every 60 seconds to save resources. The extension adapts to how you're actually using it. SMART MONEY ANALYSIS The overlay panel on Polymarket event pages shows: - Top holders for the Yes side with dollar amounts - Top holders for the No side with dollar amounts - Total capital comparison between Yes and No - A visual progress bar showing the ratio - A verdict line summarizing which way smart money leans The panel is draggable — move it anywhere on the page. Collapse it with one click if you need screen space. It automatically re-injects when you navigate between markets using Polymarket's client-side routing. TRADE HISTORY AND STORAGE PolyWhale keeps the most recent 200 whale trades cached locally. Trades older than 7 days are automatically pruned to keep storage lean. Every trade is deduplicated by transaction hash — no duplicates, even across polling cycles. All data is stored in chrome.storage.local. Nothing is sent to any external server. Your trade history, settings, and threshold preferences stay on your machine. REAL SCENARIOS WHERE THIS HELPS Pre-election market monitoring: A presidential election market on Polymarket has been stable at 62/38 for days. Suddenly, three trades totaling $180,000 land on the "No" side within 10 minutes. PolyWhale catches all three and pushes a notification. You see the shift before the odds visibly move on the chart. Crypto event speculation: Bitcoin is approaching a key technical level. You're watching the "BTC above $100K by July" market. PolyWhale shows a $67,000 BUY on the "No" side. The Smart Money panel reveals the top 5 "No" holders control 73% of the capital on that side. Useful context before you place your own position. Breaking news reaction: A geopolitical event breaks on Twitter. Within minutes, whale trades start flowing into related Polymarket events. PolyWhale's feed lights up with $5K+ trades across multiple markets. You see which events are attracting the most capital before mainstream coverage catches up. Daily morning scan: You open your browser, click the Side Panel, and see overnight whale activity at a glance. The "Today" filter shows 14 trades above your $1,000 threshold. You scan the markets, note the direction of capital flow, and plan your day accordingly. Odds verification: A market shows 85% probability. But the Smart Money panel reveals that the top holders on the minority "No" side have $2.4M in positions — more concentrated capital than the "Yes" side. The headline odds tell one story; the holder distribution tells another. Threshold fine-tuning: You start with a $100 threshold to see all activity. Too noisy. You bump it to $5,000 and the feed becomes a clean signal of meaningful trades. On high-volume days, you push it to $25,000 to focus on institutional-sized positions only. WHAT THIS EXTENSION DOES NOT DO - It does not access your Polymarket account or wallet - It does not place trades or interact with any blockchain - It does not collect, transmit, or store any personal data - It does not track your browsing activity outside of polymarket.com The only permissions it uses: - storage — Save your settings and cached trade data locally - notifications — Send desktop alerts for whale trades - sidePanel — Display the trade feed in Chrome's Side Panel - alarms — Schedule background polling every 60 seconds - Host permissions for gamma-api.polymarket.com, data-api.polymarket.com, and clob.polymarket.com — Fetch public trade data, market metadata, and real-time prices All Polymarket APIs used are public and require no authentication. The extension makes read-only requests. No API keys are stored or needed. FREE TO USE PolyWhale is completely free during the initial release. All features — whale feed, Smart Money analysis, notifications, custom thresholds — are fully unlocked. A Pro tier with additional features (extended holder data, wallet tracking, longer history retention) is planned for the future. The current free version has no usage limits and no time restrictions. THE PRICING MATH BEHIND EACH TRADE Every trade's dollar value is calculated as: Dollar Value = Number of Shares x Current Market Price The "Current Market Price" is fetched in real time from the Polymarket CLOB (Central Limit Order Book) using the SELL-side ask price — this gives the true cost to buy into that position at the moment of the trade. All token prices are fetched in a single batch request per polling cycle. This means 100 active markets require exactly 1 API call, not 200 individual requests. WHO THIS IS FOR - Polymarket traders who want to see what large players are doing before the odds move - Political and event forecasters who use Polymarket as a signal source - Crypto traders monitoring prediction market sentiment around Bitcoin, ETH, and macro events - Researchers and journalists tracking where capital flows during breaking news - Anyone who wants to understand the "why" behind sudden Polymarket price movements GETTING STARTED Install the extension, set your threshold, and open the Side Panel. Whale trades start appearing within 60 seconds. No account needed. No sign-up. No API key. Just install and watch the money move.