Polymarket Sports Edge

This is a template. The default signal compares sportsbook consensus odds against Polymarket prices and trades when divergence exceeds a threshold. Remix it — adjust the sports, threshold, sizing, or add your own filters (e.g., only trade NBA, require minimum volume, weight by recency).

What It Does

Scans active Polymarket sports markets and compares prices against the sportsbook consensus from The Odds API. When a market is mispriced relative to sharp bookmaker lines, it buys the underpriced side.

The edge: Sportsbook lines are set by professional oddsmakers with billions in handle — they're extremely well-calibrated. Polymarket sports markets are thinner and less efficient. When they disagree, the books are usually right.

How It Works

Two parallel scanning modes run each cycle:

Game-level (h2h): Matches individual Polymarket game markets against sportsbook moneylines.

1. Fetch active sports markets from Simmer (GET /api/sdk/markets?q=<sport>)
2. Fetch current h2h odds from The Odds API for the same sports
3. Match markets to games by comparing team names
4. Calculate implied probability from the sportsbook consensus (average across all bookmakers)
5. Compare against the Polymarket price — if divergence exceeds the threshold, trade

Futures (outrights): Matches Polymarket championship/winner markets against sportsbook futures odds.

1. Fetch outrights from The Odds API (_winner sport keys, e.g., basketball_nba_championship_winner)
2. Search Simmer for futures markets (e.g., "NBA championship", "Super Bowl winner")
3. Match market questions to teams in the outrights data
4. Compare sportsbook implied probability vs Polymarket price and trade divergence

Setup

Environment Variables

Get a Free Odds API Key

1. Go to the-odds-api.com
2. Sign up for the free tier (500 requests/month)
3. Copy your API key
4. Set it: export THE_ODDS_API_KEY=your_key_here

First Run Setup

When a user first installs this skill, walk them through these configuration choices before running:

1. API keys — Confirm SIMMER_API_KEY and THE_ODDS_API_KEY are set.
2. Divergence threshold (MIN_DIVERGENCE) — Default is 8%. Lower values (e.g., 5%) find more trades but with thinner edges. Higher values (e.g., 10%) are more selective. Ask the user what level of aggression they prefer.
3. Exit spread (EXIT_SPREAD) — Default is 2%. This is when the arb is considered closed and the position is sold. Tighter values exit sooner.
4. Trade size (TRADE_AMOUNT) — Default $10 per trade. Ask the user what they're comfortable risking per position.
5. Resolution window (MAX_RESOLVE_DAYS) — Default 90 days. Skip futures markets that resolve beyond this horizon. Shorter = less capital lock-up, but may miss valid opportunities.
6. Sports — By default scans all major US sports plus EPL and MLS. The user can narrow to specific leagues if they prefer.
7. Dry run — Start with LIVE=false (the default) and review a few cycles of output before going live.

Explain each setting and its trade-offs so the user can make an informed choice.

Running

# Dry run (default) — logs what it would trade
python sports_edge.py

# Live trading
LIVE=true python sports_edge.py

Example Output

[Sports Edge] Scanning 7 sports + 4 futures... (dry_run=True, min_divergence=8%)
[Sports Edge] NBA: Found 6 games with odds
[Sports Edge]   Matched: "Will the Celtics win vs Pacers?" → Boston Celtics vs Indiana Pacers
[Sports Edge]     Polymarket YES: 0.58 | Books: 0.69 | Divergence: +0.11
[Sports Edge]   DRY RUN: Would buy YES at 0.58 (edge 11%) — 10.0
[Sports Edge] Futures NBA championship: Found 30 teams in outrights
[Sports Edge]   Matched: "Will the Celtics win the 2026 NBA Champion" → Boston Celtics
[Sports Edge]     Polymarket YES: 0.12 | Books: 0.22 | Divergence: +0.10
[Sports Edge]   DRY RUN: Would buy YES at 0.12 (edge 10%) — 10.0
[Sports Edge] Done. 2 opportunities found (dry run).