# Polymarket Odds API
URL: https://sockodds.com/bookmakers/polymarket-odds-api/

> Access Polymarket betting odds through the SockOdds API. Structured JSON including head to head, lines, totals, player props and more, keyed bookmakerID=polymarket.

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](https://sockodds.com/leagues/nfl-odds-api/), [MLS](https://sockodds.com/leagues/mls-odds-api/), [MLB](https://sockodds.com/leagues/mlb-odds-api/), [La Liga](https://sockodds.com/leagues/la-liga-odds-api/), [Premier League](https://sockodds.com/leagues/epl-odds-api/), [Bundesliga](https://sockodds.com/leagues/bundesliga-odds-api/), [Ligue 1](https://sockodds.com/leagues/fr-ligue-1-odds-api/), [ATP](https://sockodds.com/leagues/atp-odds-api/), [WTA](https://sockodds.com/leagues/wta-odds-api/). 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 `decimal` alongside 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 `scoringSupported` flags where the source grades the market

## Polymarket coverage by league

| League | leagueID | Events priced |
| --- | --- | --- |
| [NFL](https://sockodds.com/leagues/nfl-odds-api/) | `NFL` | 130 |
| [MLS](https://sockodds.com/leagues/mls-odds-api/) | `MLS` | 96 |
| [MLB](https://sockodds.com/leagues/mlb-odds-api/) | `MLB` | 85 |
| [La Liga](https://sockodds.com/leagues/la-liga-odds-api/) | `LA_LIGA` | 41 |
| [Premier League](https://sockodds.com/leagues/epl-odds-api/) | `EPL` | 39 |
| [Bundesliga](https://sockodds.com/leagues/bundesliga-odds-api/) | `BUNDESLIGA` | 27 |
| [Ligue 1](https://sockodds.com/leagues/fr-ligue-1-odds-api/) | `FR_LIGUE_1` | 27 |
| [ATP](https://sockodds.com/leagues/atp-odds-api/) | `ATP` | 12 |
| [WTA](https://sockodds.com/leagues/wta-odds-api/) | `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/events` is 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-key` header or `apiKey` query parameter

### Data Update Speed

- **Odds updates** — every ~2 minutes across every bookmaker lane
- **Event status** — `status` flags and `info.stale` tell you exactly how current a price is

### Developer Resources

- [Interactive documentation](https://sockodds.com/docs/) — live examples, copy-paste snippets and an [AI (vibe coding)](https://sockodds.com/docs/info/ai-vibe-coding/) context
- [SDKs & libraries](https://sockodds.com/docs/sdk/) — the SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here
- [Postman collection](https://sockodds.com/postman-collection/) — pre-built requests ready to run
- [Support](https://sockodds.com/docs/help/) — 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](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Picklebet](https://sockodds.com/bookmakers/picklebet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [Betfair Exchange](https://sockodds.com/bookmakers/betfairexchange-odds-api/) |
| **Player props** | Home runs O/U, Pitcher strikeouts O/U | 4 oddIDs | Pre-match | [Pinnacle](https://sockodds.com/bookmakers/pinnacle-odds-api/), [Polymarket](https://sockodds.com/bookmakers/polymarket-odds-api/), [ProphetX](https://sockodds.com/bookmakers/prophetexchange-odds-api/), [Unibet](https://sockodds.com/bookmakers/unibet-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/) |

## Use Cases for Polymarket API Data

- [Arbitrage](https://sockodds.com/use-cases/arbitrage-betting-api/) & [+EV tools](https://sockodds.com/use-cases/positive-ev-betting-api/) — compare Polymarket odds across every Australian bookmaker to uncover arbitrage opportunities and positive expected value angles.
- [Odds comparison platforms](https://sockodds.com/use-cases/odds-comparison-api/) — 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](https://sockodds.com/use-cases/sports-betting-machine-learning/) — examine Polymarket line movements and betting-market patterns, and build predictive models on retained events.
- [Betting automation](https://sockodds.com/use-cases/odds-alert-bot-api/) — build systems that monitor Polymarket lines across bookmakers and trigger actions when your target odds appear.
- [Sportsbook & fantasy apps](https://sockodds.com/use-cases/sports-betting-app-api/) — 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 `notice` field
- Error handling and troubleshooting

[View documentation](https://sockodds.com/docs/)

## Start building today

Free plan available. Set up in 5 minutes. Scale when you're ready.