# Epic Odds Odds API
URL: https://sockodds.com/bookmakers/epicodds-odds-api/

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

Access Epic Odds betting odds through the SockOdds API. Structured JSON data including head to head, lines, totals, player props and more — `bookmakerID=epicodds`.

## Why choose our Epic Odds sportsbook API?

Our Epic Odds API provides clean, structured Epic Odds odds data for developers and betting platforms, eliminating the need for scraping or unstable data feeds. Australian bookmaker; appears on marquee soccer fixtures.

## Epic Odds Odds API Overview

The SockOdds Epic Odds odds API provides fast, accurate data and odds from Epic Odds across 1 leagues: [FIFA World Cup](https://sockodds.com/leagues/fifa-world-cup-odds-api/). 1 events are priced by Epic Odds right now.

With a single, unified API solution, developers can retrieve pre-match Epic Odds 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.

## Epic Odds 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

Epic Odds prices 7 distinct player-prop markets in the feed — Points / score, Shots on goal, Passes attempted, Shots — 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 Epic Odds
- **Results** — event results and `scoringSupported` flags where the source grades the market

## Epic Odds coverage by league

| League | leagueID | Events priced |
| --- | --- | --- |
| [FIFA World Cup](https://sockodds.com/leagues/fifa-world-cup-odds-api/) | `FIFA_WORLD_CUP` | 1 |

## Epic Odds 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

### Epic Odds 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 | 15 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/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [betr (sportsbook)](https://sockodds.com/bookmakers/betrsportsbook-odds-api/) |
| **Period markets** | Points / score O/U, Points / score 1X2, Points / score line, Both teams to score yes/no, Corners O/U | 28 oddIDs | Pre-match | [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [BetDeluxe](https://sockodds.com/bookmakers/betdeluxe-odds-api/), [Epic Odds](https://sockodds.com/bookmakers/epicodds-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/) |
| **Score & margin specials** | Half-time / full-time, Correct score | 30 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/), [Epic Odds](https://sockodds.com/bookmakers/epicodds-odds-api/), [Pinnacle](https://sockodds.com/bookmakers/pinnacle-odds-api/) |
| **Team & game specials** | Both teams to score yes/no | 2 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [Dabble](https://sockodds.com/bookmakers/dabble-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-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/) |
| **Cards, corners & shots** | Corners O/U, Cards O/U | 4 oddIDs | Pre-match | [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [BetRight](https://sockodds.com/bookmakers/betright-odds-api/), [Epic Odds](https://sockodds.com/bookmakers/epicodds-odds-api/), [Neds](https://sockodds.com/bookmakers/neds-odds-api/), [PlayUp](https://sockodds.com/bookmakers/playup-odds-api/) |
| **Player props** | Points / score O/U, Points / score yes/no, Shots on goal O/U, Passes attempted O/U, Shots O/U | 7 oddIDs | Pre-match | [Epic Odds](https://sockodds.com/bookmakers/epicodds-odds-api/), [MintBet](https://sockodds.com/bookmakers/mintbet-odds-api/), [BetFocus](https://sockodds.com/bookmakers/betfocus-odds-api/), [PointsBet](https://sockodds.com/bookmakers/pointsbet-odds-api/), [Sportsbet](https://sockodds.com/bookmakers/sportsbet-odds-api/), [TABtouch](https://sockodds.com/bookmakers/tabtouch-odds-api/) |

## Use Cases for Epic Odds API Data

- [Arbitrage](https://sockodds.com/use-cases/arbitrage-betting-api/) & [+EV tools](https://sockodds.com/use-cases/positive-ev-betting-api/) — compare Epic Odds 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 Epic Odds odds from every book side by side for comprehensive line shopping.
- **Pricing models & trading** — use Epic Odds market data as inputs for proprietary pricing algorithms and betting strategies.
- [Sports analytics & research](https://sockodds.com/use-cases/sports-betting-machine-learning/) — examine Epic Odds 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 Epic Odds 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 Epic Odds product with reliable odds, status and bet-slip deeplinks.

## Epic Odds Odds API Documentation

Our interactive documentation covers everything you need to integrate Epic Odds 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.