| version | 2.0.0 |
| name | Polymarket Screener |
| description | Filter Polymarket prediction markets and track probabilities. Use when screening bets, drafting analyses, outlining trends, tracking price movements. |
| author | BytesAgain |
| homepage | https://bytesagain.com |
| source | https://github.com/bytesagain/ai-skills |
Polymarket Screener 🎯
Filter and analyze prediction markets on Polymarket using their public API. Find undervalued bets, track probability movements, and discover high-opportunity markets.
Comparison: Polymarket Screener vs Manual Browsing
| Capability | Manual Browsing | Polymarket Screener |
|---|
| Filter by probability range | ❌ Limited | ✅ Exact range (e.g., 20%-40%) |
| Filter by liquidity | ❌ No | ✅ Min/max liquidity filters |
| Track probability changes | ❌ Manual checking | ✅ Automated tracking with delta |
| Multi-category scan | ❌ One at a time | ✅ All categories at once |
| Probability movement alerts | ❌ No | ✅ Configurable thresholds |
| Historical probability data | ❌ Limited chart | ✅ Exportable time series |
| Bulk opportunity scoring | ❌ No | ✅ Automated scoring |
| Custom watchlists | ❌ No | ✅ JSON watchlist with tracking |
| Export to HTML report | ❌ No | ✅ Professional report output |
| Sort by expected value | ❌ No | ✅ Built-in EV calculator |
Getting Started
No API key needed — Polymarket's public API is free.
bash scripts/polymarket-screener.sh list --limit 20
bash scripts/polymarket-screener.sh list --category politics --limit 50
bash scripts/polymarket-screener.sh opportunities --min-liquidity 50000 --prob-range "5-30"
bash scripts/polymarket-screener.sh track --market-id MARKET_SLUG --hours 48
bash scripts/polymarket-screener.sh report --output polymarket-report.html
Market Categories
- politics — Elections, legislation, government actions
- crypto — Price predictions, ETF approvals, protocol events
- sports — Game outcomes, championships, player performance
- entertainment — Awards, releases, celebrity events
- science — Space, climate, research milestones
- business — Earnings, IPOs, M&A, market indices
- world — Geopolitics, international events
Opportunity Scoring
Markets are scored based on:
Score = (Liquidity Factor × 0.3) + (Probability Edge × 0.3) + (Time Value × 0.2) + (Movement × 0.2)
Liquidity Factor: Higher liquidity = higher score (easier to enter/exit)
Probability Edge: Markets with probabilities far from 50% but trending = opportunity
Time Value: Markets resolving soon with high uncertainty = valuable
Movement: Recent probability shifts indicate new information
What Makes a Good Opportunity?
- Probability between 15-35% or 65-85% — Enough edge without extreme odds
- Liquidity > $50K — Can enter meaningful position
- Recent movement > 5% — Market is actively repricing
- Resolution within 30 days — Time value is concrete
- Your own knowledge edge — You know something the market doesn't
Output Formats
| Command | Description |
|---|
markets | Markets |
odds | Odds |
value-bets | Value Bets |
watchlist | Watchlist |
API Rate Limits
Polymarket's public API has rate limits. The screener respects these automatically:
- 60 requests/minute for listing endpoints
- 120 requests/minute for market detail endpoints
- Built-in retry with exponential backoff
Disclaimer
⚠️ Prediction markets involve real money and financial risk. This tool provides analysis only — it does not place bets or manage positions. Always do your own research.
💬 Feedback & Feature Requests: https://bytesagain.com/feedback
Powered by BytesAgain | bytesagain.com
Commands
Run polymarket-screener help to see all available commands.
