Polymarket Odds API
Access Polymarket betting odds through the SockOdds API. Structured JSON data including head to head, lines, totals, player props and more — bookmakerID=polymarket.
Why choose our Polymarket exchange API?
Our Polymarket API provides clean, structured Polymarket odds data for developers and betting platforms, eliminating the need for scraping or unstable data feeds. The largest crypto prediction market; sports contracts alongside the books.
Polymarket Odds API Overview
The SockOdds Polymarket odds API provides fast, accurate data and odds from Polymarket across 9 leagues: NFL, MLS, MLB, La Liga, Premier League, Bundesliga, Ligue 1, ATP, WTA. 292 events are priced by Polymarket right now.
With a single, unified API solution, developers can retrieve pre-match Polymarket odds, including:
- Head to head / moneylines (2-way and 3-way markets)
- Lines, spreads and handicaps
- Totals (over/under)
- Alternative lines
- Player props and game props
- Period-specific markets (quarters, halves, innings, sets, rounds)
All data is provided in structured JSON via REST endpoints, refreshed every ~2 minutes.
Polymarket API Features & Market Types
Main markets
- Head to head — 2-way and 3-way lines
- Line / handicap — spreads with the price
- Totals — over/under lines for points, goals, runs and more
- Period markets — halves, quarters, innings, sets, rounds where priced
Player props & alternate lines
Polymarket prices 4 distinct player-prop markets in the feed — Home runs, Pitcher strikeouts — plus alternative spreads and totals, team props and game props.
Pre-match data
- Pre-game odds — current odds before game time, with
decimalalongside the American string - Availability — a suspended selection is listed with
available: false, never dropped silently - Line movement tracking — every price carries
lastUpdatedAt, and finished events are retained
Deeplinks & settlement data
- Deeplinks — not yet carried for Polymarket
- Results — event results and
scoringSupportedflags where the source grades the market
Polymarket coverage by league
| League | leagueID | Events priced |
|---|---|---|
| NFL | NFL | 130 |
| MLS | MLS | 96 |
| MLB | MLB | 85 |
| La Liga | LA_LIGA | 41 |
| Premier League | EPL | 39 |
| Bundesliga | BUNDESLIGA | 27 |
| Ligue 1 | FR_LIGUE_1 | 27 |
| ATP | ATP | 12 |
| WTA | WTA | 4 |
Polymarket Odds API Technical Specifications
API Architecture
- REST API — Simple HTTP endpoints with JSON responses, identical to the SportsGameOdds v2 paths
- Polling, not push — the feed refreshes every ~2 minutes;
/v2/stream/eventsis reserved and answers 501 rather than pretending - Rate limits — per-key, per-minute meters that bind under concurrency; plans sized to your usage
- Authentication — secure API key access via the
x-api-keyheader orapiKeyquery parameter
Data Update Speed
- Odds updates — every ~2 minutes across every bookmaker lane
- Event status —
statusflags andinfo.staletell you exactly how current a price is
Developer Resources
- Interactive documentation — live examples, copy-paste snippets and an AI (vibe coding) context
- SDKs & libraries — the SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here
- Postman collection — pre-built requests ready to run
- Support — email support on every plan, priority on paid plans
Polymarket market coverage by category
| Market category | Example markets | Markets | Availability | Typical bookmakers |
|---|---|---|---|---|
| Full game lines | Points / score O/U, Points / score line, Points / score 1X2, Points / score | 9 oddIDs | Pre-match | BetFocus, MintBet, Dabble, Picklebet, BetDeluxe, Betfair Exchange |
| Player props | Home runs O/U, Pitcher strikeouts O/U | 4 oddIDs | Pre-match | Pinnacle, Polymarket, ProphetX, Unibet, Dabble, Neds |
Use Cases for Polymarket API Data
- Arbitrage & +EV tools — compare Polymarket odds across every Australian bookmaker to uncover arbitrage opportunities and positive expected value angles.
- Odds comparison platforms — display Polymarket odds from every book side by side for comprehensive line shopping.
- Pricing models & trading — use Polymarket market data as inputs for proprietary pricing algorithms and betting strategies.
- Sports analytics & research — examine Polymarket line movements and betting-market patterns, and build predictive models on retained events.
- Betting automation — build systems that monitor Polymarket lines across bookmakers and trigger actions when your target odds appear.
- Sportsbook & fantasy apps — power your Polymarket product with reliable odds, status and bet-slip deeplinks.
Polymarket Odds API Documentation
Our interactive documentation covers everything you need to integrate Polymarket odds into your project:
- Full endpoint reference with parameters and response schemas
- Live request and response examples
- Code snippets in Python, JavaScript, Ruby, Go and Java
- Authentication setup and API key management
- Rate limiting and the
noticefield - Error handling and troubleshooting
Start building today
Free plan available. Set up in 5 minutes. Scale when you're ready.