1. LEADERBOARD PAGE (home page "/")
The main page ranks the top Polymarket traders by profit. Every trader with $300+ volume is listed. Use this page to find who is actually making money — then follow their bets on the Predictions page.
SORT — Click any column header (P&L, VOLUME, % CORRECT, etc) to sort. Click again to flip direction.
SEARCH — Type a username or wallet address (0x...) in the search box to filter instantly.
TIME WINDOW — Click 1D / 7D / 30D / ALL buttons to see top traders for that time period.
VIEW POSITIONS — Click any trader row OR the "POSITIONS" button to see their open bets.
% CORRECT — Loads automatically as you scroll. Shows win rate from their closed (settled) bets.
EXTERNAL LINK — Click the arrow button to view a trader on Polymarket.com directly.
PAGINATION — Use the arrows at the bottom to page through all traders.
2. PREDICTIONS PAGE ("/predictions")
This is the core tool. It analyzes what the top traders are betting on and surfaces the strongest consensus plays. Only "smart money" traders (above 55% win rate) are counted.
TIME FILTERS:
CLOSING TODAY — Shows only markets that close within 24 hours. These are your same-day plays.
NEXT 48 HRS — Shows markets closing within 2 days. Good for planning ahead.
SIGNAL STRENGTH (color-coded):
STRONG (score 50+) — Multiple accurate whales strongly agree. Best possible signal.
GOOD (35-49) — Solid consensus from profitable traders. Worth attention.
MODERATE (25-34) — Some agreement but fewer backers or lower accuracy.
SPECULATIVE (15-24) — Weak signal. Few backers or low confidence.
WEAK (under 15) — Very low confidence. Proceed with extreme caution.
READING EACH CARD:
PRICE — What the market thinks the probability is right now. 70 cents = market thinks 70% likely.
STAKED — Total dollars the whale traders have on this outcome. $50K staked is very different from $500 staked.
EDGE STATUS:
FRESH = Whales bought below current price, edge is still alive.
WARM = Price moved partway toward the whale position.
PRICED IN = Market already caught up, easy money may be gone.
AGREE — What percentage of whale weight is on the dominant side. 90% = near-unanimous.
SCORE — Overall signal strength. Combines how many whales agree, their accuracy,
how much money they have on it, and whether the edge is fresh.
EXPANDING CARDS:
Click any prediction card to expand and see individual whale backers,
their accuracy %, entry price vs current price, dollar amounts, and
whether each backer is HOT (on the 30-day profit leaderboard).
3. WHALE FEED PAGE ("/whale-feed")
Shows live positions from the top 20 Polymarket traders. This is the raw feed of what the biggest winners are actually holding right now.
CLOSING SOON SORT — Surfaces tonight's games and near-term markets to the top
instead of distant elections. Use this for same-day action.
FILTERS — Filter by YES/NO side. Sort by value, edge, or price.
SEARCH — Search by market name or trader name to find specific positions.
HOT TRADERS — Traders marked HOT are currently on the 30-day profit leaderboard.
They are winning right now, not just historically. Their positions carry more weight.
4. CROSS-PLATFORM COMPARE ("/compare")
Compares markets across Polymarket and Kalshi to find price differences. When the same event is priced differently on two platforms, that is an arbitrage signal.
SPREAD — The price difference between platforms. A 5 cent or larger spread is notable
and may represent a trading opportunity.
MATCH COUNT — These platforms do not always cover the same markets.
The number of comparable markets varies daily.
HOW TO USE — Look for large spreads on markets you understand.
If Polymarket says 60 cents and Kalshi says 52 cents, one platform may be wrong.
5. TRACK RECORD PAGE ("/track-record")
Shows our prediction accuracy over time. This is how you verify the system actually works before committing real money.
HOW IT WORKS:
Every 6 hours, we automatically log all whale consensus predictions to a database.
When markets close, we check if our predictions were right or wrong.
WIN RATE — The percentage of resolved predictions that were correct.
This is the single most important number for trusting the system.
6. BEST PRACTICES
• Start with CLOSING TODAY predictions — these are actionable right now.
• Focus on SCORE 35+ with 3+ whale backers and FRESH edge.
• Cross-reference with the Whale Feed to see the dollar amounts behind each position.
• Use Track Record to verify the system works before committing real money.
• Higher STAKED amount + FRESH edge + high AGREE % = strongest possible signal.
• If a prediction shows PRICED IN, the whales already got their gains — you might be late.
• HOT backers (on 30-day leaderboard) matter more than all-time leaders for short-term trades.
• Predictions are NOT financial advice. Past accuracy does not guarantee future results.
Always do your own research before trading.
7. FINDING A SPECIFIC WALLET'S PREDICTIONS
There are 3 ways to look up what a specific wallet or user is betting on:
METHOD 1 — LEADERBOARD (easiest):
Search for the username or paste the wallet address (0x...) on the home page.
Click their row to expand and see all their open positions.
METHOD 2 — TRADER LOOKUP (this page, below):
Scroll down to the "TRADER LOOKUP" section on this controls page.
Paste a wallet address or type a username and click LOOKUP.
METHOD 3 — RAW API INSPECTOR (advanced):
Select "positions" from the dropdown, type user=0xWALLETADDRESS&limit=50,
and click SEND to see raw position data with exact share counts and P&L.
8. CONTROLS ON THIS PAGE
HEALTH MONITOR — Tests if all API endpoints are working. Red = API may be down.
QUICK LEADERBOARD TEST — Pulls a few traders to verify data is flowing.
LEADERBOARD CONFIG — Adjust min volume filter, page size, and fetch depth.
Click SAVE TO BROWSER to keep settings. Refresh the main page after saving.
TRADER LOOKUP — Look up any trader by wallet or username. Shows stats + open positions.
RAW API INSPECTOR — Send custom API requests and see raw JSON responses.
Endpoints include leaderboard, positions, predictions, whale-feed,
compare (cross-platform), and track-record data.
Useful for debugging or getting data not shown on the main pages.