Polymarket Scanner
Automated Polymarket prediction market scanner and trader via Simmer API. Use when analyzing prediction markets, scanning for trading opportunities, executing virtual ($SIM) or real (USDC) trades, checking positions, or managing a Polymarket portfolio. Triggers on "polymarket", "prediction market", "simmer", "trade", "market scan", "betting odds", "arbitrage opportunities".
Polymarket Scanner
Automated prediction market scanner that finds mispriced markets and executes trades via the Simmer Markets API.
Setup
Required
SIMMER_API_KEYenv var (get from https://simmer.markets)- Simmer agent registered and claimed
Optional
- Telegram bot for trade notifications
Commands
Auto-scan (default)
python scripts/scanner.py
Scans top 20 opportunities, filters by score/divergence/warnings, executes qualifying trades.
Check positions
python scripts/scanner.py --positions
Check balance
python scripts/scanner.py --status
Trading Rules (built-in)
| Rule | Virtual ($SIM) | Real (USDC) |
|---|---|---|
| Single trade | ≤10% balance | ≤$100 |
| Daily limit | ≤30% balance | ≤$500 |
| Stop-loss | -15% | -10% |
| Max positions | 5 | 3 |
| Min opportunity score | 25 | 40 |
| Min divergence | 3% | 5% |
Strategy
- Cross-platform arbitrage — Price divergence between Polymarket and external sources
- Momentum shifts — Rapid price changes indicating mispricing
- Data-driven events — Weather, economic data, quantifiable outcomes preferred
Architecture
Cron (every 4h) → scanner.py → Simmer API
├── Get balance & positions
├── Scan opportunities (score, divergence, warnings)
├── Filter by trading rules
├── Execute qualifying trades (SIM auto, USDC manual)
└── Log to trading_log.jsonl
Risk Controls
- All trades logged to
trading_log.jsonl - Serious spread warnings (>10%) auto-skip
- Already-held markets auto-skip
- Balance <$100 auto-stop
- Real USDC trades require human confirmation
Related skills
- Downloads
- 1.1kAll time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v1.0.0
- License
- MIT-0
