Real-time detection of large and early trades on Polymarket. Track specific markets, monitor whale wallets, and get instant notifications.
Download the latest binary for your platform from Releases:
macOS (Apple Silicon):
curl -L -o polymarket-tool https://github.com/mikefdy/polymarket-tool/releases/latest/download/polymarket-tool-darwin-arm64
chmod +x polymarket-tool
sudo mv polymarket-tool /usr/local/bin/macOS (Intel):
curl -L -o polymarket-tool https://github.com/mikefdy/polymarket-tool/releases/latest/download/polymarket-tool-darwin-amd64
chmod +x polymarket-tool
sudo mv polymarket-tool /usr/local/bin/Linux:
curl -L -o polymarket-tool https://github.com/mikefdy/polymarket-tool/releases/latest/download/polymarket-tool-linux
chmod +x polymarket-tool
sudo mv polymarket-tool /usr/local/bin/Windows (PowerShell):
Invoke-WebRequest -Uri https://github.com/mikefdy/polymarket-tool/releases/latest/download/polymarket-tool.exe -OutFile polymarket-tool.exe
Move-Item polymarket-tool.exe C:\Windows\System32\Requires Go 1.21+:
go build -o polymarket-tool .# Add a market to watch
polymarket-tool add-market https://polymarket.com/event/fed-decision-in-january
# Add top traders to whale list
polymarket-tool discover-whales top10
# Start tracking
polymarket-tool startStarts the real-time tracker. Monitors all watched markets for fat trades via WebSocket.
# Basic
polymarket-tool start
# With custom thresholds
MIN_TRADE_USD=500 polymarket-tool start
# With Discord/Slack webhook
WEBHOOK_URL=https://discord.com/api/webhooks/... polymarket-tool startSearch for markets and interactively add them to your watch list.
# Interactive search
polymarket-tool markets
# Search with query
polymarket-tool markets fed
polymarket-tool markets trump tariffsAdd a Polymarket event directly by URL or slug.
# By URL
polymarket-tool add-market https://polymarket.com/event/fed-decision-in-january
# By slug
polymarket-tool add-market fed-decision-in-januaryScan historical trades for your saved markets and show fat trades.
# Use default threshold ($1000)
polymarket-tool fat-trades
# Custom threshold
polymarket-tool fat-trades 5000
polymarket-tool fat-trades 500Fetch the Polymarket leaderboard and add profitable traders to your whale list.
# Interactive mode
polymarket-tool discover-whales
# Add top N traders
polymarket-tool discover-whales top5
polymarket-tool discover-whales top20
# Add specific ranks
polymarket-tool discover-whales 1,2,3
# Add all untracked
polymarket-tool discover-whales allView recent trades for tracked whales.
# All whales (default 20 trades each)
polymarket-tool whale-trades
# Specific whale by name
polymarket-tool whale-trades beachboy4
# With custom limit
polymarket-tool whale-trades beachboy4 50
# By index (from list)
polymarket-tool whale-trades 1View and manage tracked whales and markets.
# List tracked whales
polymarket-tool list whales
# List saved markets
polymarket-tool list markets
# Clear all saved markets
polymarket-tool list clear-markets
# Clear all tracked whales
polymarket-tool list clear-whales
# Remove a whale
polymarket-tool list remove-whale 0x123...
# Remove a market
polymarket-tool list remove-market fed-decision-in-januarySet via environment variables:
| Variable | Default | Description |
|---|---|---|
MIN_TRADE_USD |
1000 | Minimum trade value to trigger alert |
MIN_LIQUIDITY_RATIO |
0.05 | Min trade size as % of orderbook (5%) |
WEBHOOK_URL |
- | Discord/Slack webhook for notifications |
SEARCH_QUERIES |
trump,russia,china,war,election | Comma-separated market search terms |
POLL_INTERVAL_MS |
30000 | Market list refresh interval (ms) |
A trade triggers an alert if ANY of these conditions are met:
- Large trade - Value ≥
MIN_TRADE_USD - High liquidity ratio - Trade size ≥
MIN_LIQUIDITY_RATIOof orderbook - Early market - Market < 24h old AND trade ≥ 50% of
MIN_TRADE_USD - Whale trade - Trader is in your whale list (any size)
Tracked whales and markets are stored in data/:
data/
├── whales.json # Wallet addresses, names, PnL, volume
└── markets.json # Market slugs and titles
Edit these files directly to add/remove entries manually.
============================================================
🐋 FAT TRADE DETECTED
Market: Fed decreases interest rates by 25 bps?
Outcome: Yes
Side: BUY
Size: 1000.00 @ 0.8500
Value: $850.00
Reason: Large trade: $850.00 | 🐋 Whale: beachboy4
URL: https://polymarket.com/event/fed-decision-in-january
Time: 2026-01-17T19:57:06Z
============================================================
Set WEBHOOK_URL to receive rich embed notifications with trade details.
polymarket-tool add-market https://polymarket.com/event/trump-tariffs-china
polymarket-tool startpolymarket-tool add-market https://polymarket.com/event/fed-decision-in-january
polymarket-tool discover-whales top10
MIN_TRADE_USD=100 polymarket-tool startMIN_TRADE_USD=50 \
MIN_LIQUIDITY_RATIO=0.02 \
WEBHOOK_URL=https://discord.com/api/webhooks/xxx/yyy \
polymarket-tool startRequires Go 1.21+:
# Build for current platform
go build -o polymarket-tool .
# Cross-compile for other platforms
GOOS=linux GOARCH=amd64 go build -o polymarket-tool-linux .
GOOS=darwin GOARCH=arm64 go build -o polymarket-tool-darwin-arm64 .
GOOS=windows GOARCH=amd64 go build -o polymarket-tool.exe .- Gamma API - Market discovery and metadata
- CLOB API - Orderbook and pricing
- Data API - Historical trades and leaderboard
- WebSocket - Real-time trade stream