Polymarket Screener

# 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
# List active markets
bash scripts/polymarket-screener.sh list --limit 20

# Filter by category
bash scripts/polymarket-screener.sh list --category politics --limit 50

# Find high-opportunity markets (low probability, high liquidity)
bash scripts/polymarket-screener.sh opportunities --min-liquidity 50000 --prob-range "5-30"

# Track probability changes
bash scripts/polymarket-screener.sh track --market-id MARKET_SLUG --hours 48

# Generate full screening report
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 milesto...