# SockOdds API

Last updated: 2026-09
API version: v2
Canonical name: SockOdds (also: sockodds.com). The Australian extension of the SportsGameOdds v2 schema.

Updated with major releases and documentation changes.

> Australian sports betting odds API for developers: 21 Australian bookmakers (Sportsbet, TAB, Ladbrokes, Neds, PointsBet, Unibet, bet365 and more) plus Pinnacle, the Betfair Exchange, Kalshi and Polymarket; 34 leagues across 12 sports including the AFL, NRL and IPL; 1192+ markets. Same paths, envelope and oddID grammar as SportsGameOdds. Free tier available.

## What developers build with this API

- Arbitrage Betting — An arbitrage betting API that returns every Australian book's price per market through byBookmaker, so you can scan every bookmaker and alt line for arbs and middles.
- Odds Comparison — Compare bookmaker odds with one API call. SockOdds returns every book's price under byBookmaker, a consensus line, and click-to-bet deeplinks.
- Positive EV Betting — Positive EV betting API with no-vig fairOdds and every AU book's price side by side, so you can surface +EV bets without building your own devig pipeline.
- Live & In-Play Odds — Pre-match lines and live event status across every Australian book, refreshed every couple of minutes, with the honest flags a live product needs.
- Parlay Builders — A multi and same-game-multi builder API: pull every market as a leg (props, alt lines, game markets), normalise via oddID, and compute combined odds.
- Betting Apps — The sports betting app API with odds from every major Australian bookmaker, event status, results, and click-to-bet deeplinks in a single feed.
- Bet Tracking & Settlement — A bet tracking and settlement API: grade bets from results and the started/ended/finalized flags. Odds and results arrive in one feed.
- DFS Data — A DFS data API for Australian pick'em and lineup tools: player props from the books plus Dabble's pick'em lane, then turn no-vig fair odds into projections.
- Historical Odds Data — Finished events are never pruned from the feed, so an odds archive of every Australian book starts the day you start pulling.
- Betting Models & ML — Sports betting machine learning data API with retained events, no-vig fair odds labels, and results for training and backtesting models on AFL, NRL and more.
- Odds Alert Bots — Build a sports odds alert bot for Discord or Telegram: diff odds across every AU book to detect line moves and push deeplinks to users.
- AI Agents & MCP — Add live Australian odds to AI agents with the SportsGameOdds MCP server pointed at SockOdds, the five SGO SDKs, and LLM-ready docs.
- Live Scores & Sports Data — Event status, results and team data across every code Australia follows, with odds in the same schema.
- Prediction Market Arbitrage — Compare Kalshi and Polymarket prices against Australian sportsbook odds in one schema. Find exchange-vs-book arbitrage in one odds API.

## Key differentiators

- Drop-in for SportsGameOdds clients: change the base URL to https://api.sockodds.com/v2
- Every Australian bookmaker, with event and bet-slip deeplinks from the books' own ids
- AFL, AFLW, NRL, NRLW, State of Origin, rugby union internationals and the IPL alongside the world's leagues
- Decimal price on every bookmaker entry next to the American string
- Consensus (bookOdds) and de-vigged fair odds (fairOdds) from exchange and sharp sources
- Honest flags: available, info.stale, notice
- Finished events retained (no pruning)

## Pricing summary

- Lite (Free): 10 requests per minute, ~2 min update frequency, 2 leagues (AFL + NRL), 3 bookmakers
- Base ($69/month): 60 requests per minute, ~2 min update frequency, All leagues, 10 bookmakers
- Platform (custom): 600 requests per minute, Max update frequency, All leagues, Every bookmaker, no cap

Key pricing note: charged per event object, not per market or bookmaker. One event with 200 markets = 1 object consumed.

Full pricing: https://sockodds.com/pricing/

## Commonly compared to

SockOdds is frequently compared to The Odds API and OpticOdds. It is not compared to SportsGameOdds: it extends that schema rather than competing with it.

vs SportsGameOdds: the same paths, envelope and oddID grammar — an SGO client reaches SockOdds by changing one base URL. SockOdds adds the Australian bookmakers and the AFL, NRL, cricket and rugby union leagues SGO does not carry; SGO carries the US and European leagues and books SockOdds does not.

vs The Odds API: bookmakers 40+ brands (own count); REST only; pricing Per credit: markets × regions per call, $0–$249/mo. Australian coverage: An AU region with the major Australian brands; no AU bet-slip links. Choose The Odds API if you want the cheapest entry credits or futures/outrights.

vs OpticOdds: bookmakers 100–200+ (docs vs marketing); SSE; pricing Contact — reported $499–$5,000+/mo per sport. Australian coverage: Not published. Choose OpticOdds if you are an operator or trading desk with a budget for an enterprise contract.

Full comparisons: https://sockodds.com/compare/

## Limitations and when to choose a competitor

- No WebSocket streaming (/v2/stream/events answers 501); poll every ~2 minutes
- Opening and closing prices are not snapshotted (includeOpenCloseOdds accepted, no effect)
- Pre-match feed; live prices refresh at the same ~2 minute cadence
- Free tier limited to AFL and NRL from 3 bookmakers
- Not a bet placement API — data only
- Choose The Odds API if you want the cheapest entry credits or futures/outrights
- Choose OpticOdds if you are an operator or trading desk with a budget for an enterprise contract
- Choose SportsDataIO if you need licensed all-in-one US stats and odds
- Choose Unabated if your edge is US sharp/CLV work at a professional budget
- Choose TheRundown if you want a US-centric feed with a points-based free tier
- Choose Sportradar if you need officially licensed data at enterprise scale

## Machine-readable resources and tooling

- OpenAPI 3.1 specification: https://sockodds.com/openapi.json (also advertised on every page as `<link rel="service-desc">`)
- Postman collection: https://sockodds.com/SockOdds_Postman_Collection.json
- Documentation index for LLMs: https://sockodds.com/llms.txt
- Full documentation text: https://sockodds.com/docs/llms-full.txt
- Full site knowledge payload: https://sockodds.com/llms-full.txt
- Sitemap: https://sockodds.com/sitemap.xml
- Markdown version of any page: send `Accept: text/markdown`, or append `.md` to the URL

### Official SDKs

The five official SportsGameOdds SDKs work unchanged against SockOdds: set the base URL to https://api.sockodds.com/v2 (environment variable `SPORTS_GAME_ODDS_BASE_URL`).

- TypeScript/JavaScript: `npm install sports-odds-api`
- Python: `pip install sports-odds-api`
- Ruby: `gem "sports-odds-api"`
- Go: `go get github.com/SportsGameOdds/sports-odds-api-go`
- Java: `com.sportsgameodds.api:sports-odds-api`
- Source for all five: https://github.com/SportsGameOdds

### MCP server

Official MCP server for AI coding tools (Claude Code, Cursor, Copilot): run `npx -y sports-odds-api-mcp` with `SPORTS_GAME_ODDS_BASE_URL=https://api.sockodds.com/v2`. Version 2.1.0 exposes two tools — `execute` (runs SDK calls; needs Deno on the machine) and `search_docs`.
Setup instructions: https://sockodds.com/docs/info/ai-vibe-coding/

## Website

- [Homepage](https://sockodds.com/): Overview of the SockOdds API — bookmaker coverage, use cases, pricing summary.
- [Pricing and plans](https://sockodds.com/pricing/): Full plan comparison — Lite (free), Base and Platform tiers with request rates, league coverage and bookmaker limits.
- [FAQ](https://sockodds.com/faq/): Common questions on pricing, coverage, rate limits and integration.
- [Bookmakers — full list](https://sockodds.com/bookmakers/): All 25 supported bookmakers with coverage details, lanes and league availability.
- [Leagues](https://sockodds.com/leagues/): All 34 leagues with leagueIDs, market families and the books pricing them.
- [Sports](https://sockodds.com/sports/): All 12 sports with sportIDs and their leagues.
- [Player Props API](https://sockodds.com/player-props-odds-api/): Player prop odds from every Australian bookmaker across the AFL, NRL, cricket and the world's leagues, with the full market list by sport and how to filter props in a request.
- [Prediction Market API](https://sockodds.com/prediction-market-api/): Kalshi and Polymarket prices alongside Australian sportsbook odds in one schema.
- [Blog](https://sockodds.com/blog/): Tutorials, integration guides, use-case walkthroughs and API updates.
- [About](https://sockodds.com/about/): What SockOdds is, where the data comes from, and who runs it.
- [Contact](https://sockodds.com/contact-us/): Get in touch with the SockOdds team.

## Bookmakers

25 bookmakers, 21 of them Australian. Individual integration guides:

### Australian bookmakers
- [Sportsbet odds API](https://sockodds.com/bookmakers/sportsbet-odds-api/): Australia's largest online bookmaker; the deepest AU market catalogue in the feed. bookmakerID: sportsbet
- [Unibet odds API](https://sockodds.com/bookmakers/unibet-odds-api/): Kindred's Australian book; one of the widest league lists in the feed. bookmakerID: unibet
- [TAB odds API](https://sockodds.com/bookmakers/tab-odds-api/): Tabcorp's national wagering brand, with a bet-slip deeplink strategy on every priced event. bookmakerID: tab
- [PlayUp odds API](https://sockodds.com/bookmakers/playup-odds-api/): Australian book with unusually wide global league coverage. bookmakerID: playup
- [TABtouch odds API](https://sockodds.com/bookmakers/tabtouch-odds-api/): The Western Australian TAB, priced separately from TAB. bookmakerID: tabtouch
- [BetRight odds API](https://sockodds.com/bookmakers/betright-odds-api/): Australian bookmaker with broad soccer and US coverage. bookmakerID: betright
- [Neds odds API](https://sockodds.com/bookmakers/neds-odds-api/): Entain's second Australian brand; broad league coverage including AFLW and NRL. bookmakerID: neds
- [Picklebet odds API](https://sockodds.com/bookmakers/picklebet-odds-api/): Esports-first Australian book that also prices the major codes. bookmakerID: picklebet
- [PointsBet odds API](https://sockodds.com/bookmakers/pointsbet-odds-api/): Australian-founded book with wide US-league and same-game coverage. bookmakerID: pointsbet
- [BetDeluxe odds API](https://sockodds.com/bookmakers/betdeluxe-odds-api/): Australian bookmaker; every major code plus tennis and soccer. bookmakerID: betdeluxe
- [betr (sportsbook) odds API](https://sockodds.com/bookmakers/betrsportsbook-odds-api/): betr's sportsbook lane, priced separately from its headline product. bookmakerID: betrsportsbook
- [BetFocus odds API](https://sockodds.com/bookmakers/betfocus-odds-api/): Australian bookmaker with a same-game-multi lane. bookmakerID: betfocus
- [MintBet odds API](https://sockodds.com/bookmakers/mintbet-odds-api/): Australian bookmaker with a same-game-multi lane. bookmakerID: mintbet
- [Ladbrokes odds API](https://sockodds.com/bookmakers/ladbrokes-odds-api/): Entain's Australian flagship, strong on US majors and racing-adjacent markets. bookmakerID: ladbrokes
- [SwiftBet odds API](https://sockodds.com/bookmakers/swiftbet-odds-api/): Australian bookmaker, AFL/NRL and European soccer. bookmakerID: swiftbet
- [betr odds API](https://sockodds.com/bookmakers/betr-odds-api/): News Corp-backed Australian bookmaker. bookmakerID: betr
- [CrownBet odds API](https://sockodds.com/bookmakers/crownbet-odds-api/): Legacy Australian brand still priced on tennis and rugby internationals. bookmakerID: crownbet
- [bet365 odds API](https://sockodds.com/bookmakers/bet365-odds-api/): bet365's Australian site. Captured through a separate lane; coverage is narrower than the other AU books. bookmakerID: bet365
- [Epic Odds odds API](https://sockodds.com/bookmakers/epicodds-odds-api/): Australian bookmaker; appears on marquee soccer fixtures. bookmakerID: epicodds

### International and sharp bookmakers
- [Pinnacle odds API](https://sockodds.com/bookmakers/pinnacle-odds-api/): The sharp book. Its prices are the reference for fair odds across the feed. bookmakerID: pinnacle

### Betting exchanges and prediction markets
- [Polymarket odds API](https://sockodds.com/bookmakers/polymarket-odds-api/): The largest crypto prediction market; sports contracts alongside the books. bookmakerID: polymarket
- [Kalshi odds API](https://sockodds.com/bookmakers/kalshi-odds-api/): US-regulated prediction market; sports contracts priced alongside the books. bookmakerID: kalshi
- [ProphetX odds API](https://sockodds.com/bookmakers/prophetexchange-odds-api/): US peer-to-peer exchange; another vig-free anchor for fair prices. bookmakerID: prophetexchange
- [Betfair Exchange odds API](https://sockodds.com/bookmakers/betfairexchange-odds-api/): The Australian Betfair exchange — back and lay prices that anchor fair odds. bookmakerID: betfairexchange

### Pick'em and DFS platforms
- [Dabble odds API](https://sockodds.com/bookmakers/dabble-odds-api/): Social betting app; its pick'em lane is the closest thing in Australia to a DFS board. bookmakerID: dabble

Full bookmaker list: https://sockodds.com/bookmakers/

## Documentation

- [Documentation](https://sockodds.com/docs.mdx): SockOdds API docs: Australian sports betting odds API with 21 Australian bookmakers, 34 leagues, in the SportsGameOdds schema. Free tier available.
- [API Reference - Endpoints and Parameters](https://sockodds.com/docs/reference.mdx): Complete SockOdds API reference with live request builders: all endpoints, query parameters, request/response schemas.
- [Data Explorer - Browse API Data Schema](https://sockodds.com/docs/explorer.mdx): Interactive tool to browse SockOdds API data: sports, leagues, teams, events and odds markets, with a live request runner.
- [SDK Guide - TypeScript, Python, Ruby, Go, Java](https://sockodds.com/docs/sdk.mdx): The official SportsGameOdds SDKs for TypeScript, Python, Ruby, Go and Java, pointed at SockOdds: install, pagination, filtering, errors, retries.
- [FAQ - Common Questions and Troubleshooting](https://sockodds.com/docs/faq.mdx): Answers to common SockOdds API questions: authentication, filtering, rate limits, error handling, oddID format, player props, historical data.
- [Support - Get Help with the API](https://sockodds.com/docs/help.mdx): Contact SockOdds support by email or the contact form. How we prioritise issues and what to include when reporting one.

### Basics

- [Introduction](https://sockodds.com/docs/basics.mdx): Australian sports betting odds API in the SportsGameOdds schema. Pay per event, not per market. Get odds, status and player props in one request.
- [Setup Guide - API Keys and Authentication](https://sockodds.com/docs/basics/setup.mdx): Get your SockOdds API key and authenticate requests. Use the x-api-key header or apiKey query param. Includes SDK install and code examples.
- [Quickstart - First API Call in 5 Minutes](https://sockodds.com/docs/basics/quickstart.mdx): Make your first SockOdds API call with copy-paste code examples. Fetch AFL and NRL odds in JavaScript, Python, Ruby, PHP, Java or Go.
- [API Cheat Sheet - Quick Reference](https://sockodds.com/docs/basics/cheat-sheet.mdx): SockOdds API cheat sheet with endpoints, authentication, oddID format and response structure.
- [AI-Assisted Development - MCP Server and Context](https://sockodds.com/docs/info/ai-vibe-coding.mdx): Use Claude Code, Cursor or Copilot with the SockOdds API: the SGO MCP server pointed here, llms.txt, and copy-paste AI context.

### Guides

- [Pagination Guide - Cursor-Based Batching](https://sockodds.com/docs/guides/data-batches.mdx): Fetch large datasets with cursor pagination. Use nextCursor and limit to iterate through events, teams, players and markets.
- [Handling Odds - Parse Results and Grade Bets](https://sockodds.com/docs/guides/handling-odds.mdx): Access odds data from events, grade over/under and line bets using results and the market grammar. JavaScript example.
- [Teams Guide - Fetch by ID, League, or Sport](https://sockodds.com/docs/guides/fetching-teams.mdx): Query /teams by teamID, leagueID or sportID, and /players by event. Team names, ids and colours where the source carries them.
- [Optimize Response Speed and Latency](https://sockodds.com/docs/guides/response-speed.mdx): Reduce API response times with oddID filtering, the PLAYER_ID wildcard, includeOpposingOdds and bookmakerID.
- [Real-Time Data (Polling) - Streaming API](https://sockodds.com/docs/guides/realtime-streaming-api.mdx): SockOdds does not stream. The polling-and-diff pattern that replaces WebSocket feeds, in JavaScript, Python and Ruby.
- [Best Practices and Common Mistakes](https://sockodds.com/docs/info/best-practices.mdx): API best practices for security, performance and cost: server-side sync, filtering, retries, honesty flags. Common mistakes to avoid.

### Data Types

- [Data Types Overview - API Schema Reference](https://sockodds.com/docs/data-types.mdx): How SockOdds API data types relate: sports, leagues, teams, events, odds and bookmakers with identifier formats.
- [Supported Markets - Odds Coverage by League](https://sockodds.com/docs/data-types/markets.mdx): Interactive market browser showing oddID coverage by league and bookmaker. Filter by sport, bet type, market type or bookmaker.
- [Bookmaker Data Type - bookmakerID](https://sockodds.com/docs/data-types/bookmakers.mdx): Complete list of bookmakerID values: Sportsbet, TAB, Ladbrokes, Neds, PointsBet, Unibet, bet365, Pinnacle, Betfair Exchange, Kalshi, Polymarket and more.
- [Sports Data Type - sportID](https://sockodds.com/docs/data-types/sports.mdx): Complete list of sportID values: Aussie rules, rugby league, rugby union, cricket, soccer, basketball, baseball, hockey, tennis, MMA, motorsports, American football.
- [League Data Type - leagueID](https://sockodds.com/docs/data-types/leagues.mdx): Complete list of leagueID values: AFL, NRL, NRLW, IPL, EPL, NFL, NBA, MLB and 34 leagues across all major sports.
- [Stat Data Type - statID](https://sockodds.com/docs/data-types/stats.mdx): All statID values organised by sport: points, disposals, tries, goals, hits, shots and player props for every supported sport.
- [Stat Entity Data Type - statEntityID](https://sockodds.com/docs/data-types/stat-entity.mdx): How statEntityID works: home, away, all, a playerID for props, or a teamID for tournaments.
- [Period Data Type - periodID](https://sockodds.com/docs/data-types/periods.mdx): All periodID values: full game, halves, quarters, innings, overs, periods, sets and season.
- [Bet Type and Side Data Types - betTypeID and sideID](https://sockodds.com/docs/data-types/bet-types.mdx): All betTypeID and sideID values: moneyline (ml), spread (sp), over/under (ou), 3-way, yes/no, pick markets and cricket bet types.
- [Odds Data Type - oddID](https://sockodds.com/docs/data-types/odds.mdx): How oddID works: statID-statEntityID-periodID-betTypeID-sideID, with examples and the odds field reference.

### Endpoints

- [GET /events - Fetch Games, Odds, and Results](https://sockodds.com/docs/endpoints/getEvents.mdx): Retrieve sports events with odds, status, teams, players, results and bookmaker links. Filter by league, team, date or odds market. Includes every bookmaker line your plan allows.
- [GET /odds/history - Fetch Odds Movement](https://sockodds.com/docs/endpoints/getOddsHistory.mdx): SockOdds extension. Every price, line and bet-limit change every bookmaker has published for one event, oldest first — the raw movement behind opening, closing and steam. Captured since 2026-08-14 and kept indefinitely; the last ~28 days are answered from the live store and everything older from the archive.
- [GET /teams - Fetch Team Data](https://sockodds.com/docs/endpoints/getTeams.mdx): Retrieve team information including names, colours and identifiers. Filter by teamID, leagueID or sportID. Supports pagination.
- [GET /players - Fetch Player Data](https://sockodds.com/docs/endpoints/getPlayers.mdx): Retrieve player information including names, team and identifiers. Filter by playerID, teamID or eventID. Supports pagination.
- [GET /sports - List All Sports](https://sockodds.com/docs/endpoints/getSports.mdx): Retrieve all supported sports with their sportID values.
- [GET /leagues - List All Leagues](https://sockodds.com/docs/endpoints/getLeagues.mdx): Retrieve all supported leagues with leagueID values. `enabled` reflects what your plan can see.
- [GET /stats - List All Stats](https://sockodds.com/docs/endpoints/getStats.mdx): Retrieve all supported statistics with statID values. Filter by sportID and by the level (all, team, player) the stat is priced at.
- [GET /markets - Fetch Market Metadata](https://sockodds.com/docs/endpoints/getMarkets.mdx): Retrieve metadata about markets, keyed by oddID: identifiers, display names, classification (main markets, props, prop type, sub-periods) and which leagues and bookmakers currently price each one.
- [GET /account/usage - Check API Usage and Limits](https://sockodds.com/docs/endpoints/getUsageData.mdx): Check your API key's tier, rate limits and current usage by interval. Calling it counts as a request like any other.
- [Stream Events](https://sockodds.com/docs/endpoints/streamEvents.mdx): Reserved. SockOdds does not stream: the source refreshes every ~2 minutes and this endpoint answers 501 so a client written for SportsGameOdds fails loudly instead of waiting on a socket that never opens.

### Other Info

- [Sports Betting Glossary - Terms and Definitions](https://sockodds.com/docs/info/glossary.mdx): Betting terminology explained with API field mappings: head to head, line, total, juice, arbitrage, closing line value, multi, SGM and more.
- [Error Codes and Troubleshooting](https://sockodds.com/docs/info/errors.mdx): Full reference of all error codes, what they mean and how to troubleshoot them, with retry examples in five languages.
- [Consensus Odds - Fair and Book Calculations](https://sockodds.com/docs/info/consensus-odds.mdx): How fairOdds and bookOdds are calculated: sharp-source consensus with the margin removed, median main-line price across bookmakers.
- [Migration Guide - V1 to V2 API](https://sockodds.com/docs/info/v1-to-v2.mdx): Upgrade from SportsGameOdds v1 to v2 and run the result against SockOdds: combined /events endpoint, new playerID format, deeplinks, altLines, field renames.
- [Rate Limits by Plan - Requests and Objects](https://sockodds.com/docs/info/rate-limiting.mdx): Rate limits for Lite, Base and Platform plans. Atomic per-minute meters, the notice field, and checking usage via /account/usage.
- [Pointing a SportsGameOdds client at SockOdds](https://sockodds.com/docs/info/migrating-from-sgo.mdx): Point an existing SportsGameOdds integration at SockOdds: change the base URL, keep the parsing, know the Australian leagueIDs and bookmakerIDs.

### Examples

- [Live Odds Tracker Example - JavaScript](https://sockodds.com/docs/examples/live-odds-tracker.mdx): Complete working example that tracks AFL odds every 2.5 minutes and detects line movement across every Australian bookmaker.
- [Arbitrage Calculator Example - Python](https://sockodds.com/docs/examples/arbitrage-calculator.mdx): Find cross-bookmaker margins by identifying odds discrepancies across every Australian book.
- [Odds Comparison Dashboard Example - React/Next.js](https://sockodds.com/docs/examples/odds-comparison-dashboard.mdx): Create a Next.js dashboard that compares odds across every Australian bookmaker and highlights the best line.
- [Player Props Analyzer Example - Python](https://sockodds.com/docs/examples/player-props-analyzer.mdx): Analyze player prop bets by fetching props for an event and comparing lines across every Australian bookmaker.
- [Parlay Calculator Example - JavaScript](https://sockodds.com/docs/examples/parlay-builder.mdx): Build a multi (parlay) calculator that combines multiple legs and calculates total odds and payout from live Australian prices.

## Full knowledge payload

For detailed product knowledge, FAQs, use-case descriptions, pricing context,
glossary, and full comparison information, see:
https://sockodds.com/llms-full.txt