# SockOdds API — Full Knowledge Payload > This file is intended for AI systems, crawlers, and language models. > It contains the complete reference for sports coverage, league pages, > bookmaker pages, use cases, blog content, and supplementary knowledge not > included in llms.txt. For the orientation file, see https://sockodds.com/llms.txt > Last updated: September 2026 --- ## Sports coverage 12 sports covered. Full index: https://sockodds.com/sports/ - [Aussie Rules Odds API](https://sockodds.com/sports/aussie-rules-football-odds-api/): Leagues: AFL, AFLW. sportID: AUSSIE_RULES - [Baseball Odds API](https://sockodds.com/sports/baseball-odds-api/): Leagues: MLB. sportID: BASEBALL - [Basketball Odds API](https://sockodds.com/sports/basketball-odds-api/): Leagues: NBA. sportID: BASKETBALL - [Cricket Odds API](https://sockodds.com/sports/cricket-odds-api/): Leagues: IPL. sportID: CRICKET - [American Football Odds API](https://sockodds.com/sports/football-odds-api/): Leagues: NFL. sportID: FOOTBALL - [Ice Hockey Odds API](https://sockodds.com/sports/hockey-odds-api/): Leagues: NHL. sportID: ICE_HOCKEY - [MMA Odds API](https://sockodds.com/sports/mma-odds-api/): Leagues: UFC. sportID: MMA - [Motorsports Odds API](https://sockodds.com/sports/motorsports-odds-api/): Leagues: F1. sportID: MOTOR_RACING - [Rugby League Odds API](https://sockodds.com/sports/rugby-league-odds-api/): Leagues: NRL, RUGBYLEAGUE_NRLW, RUGBYLEAGUE_STATE_ORIGIN. sportID: RUGBY_LEAGUE - [Rugby Union Odds API](https://sockodds.com/sports/rugby-union-odds-api/): Leagues: RUGBYUNION_INTERNATIONALS. sportID: RUGBY_UNION - [Soccer Odds API](https://sockodds.com/sports/soccer-odds-api/): Leagues: BR_SERIE_A, BUNDESLIGA, EPL, FIFA_WORLD_CUP, FR_LIGUE_1, ICELAND_1_DEILD, ICELAND_BESTA_DEILD, IT_SERIE_A, LA_LIGA, MLS, SCOTTISH_PREM, SLOVAK_2_LIGA, SLOVAK_SUPER_LIGA, UCL, UECL, UEFA_CHAMPIONS_LEAGUE_QUALIFIERS, UEFA_CONFERENCE_LEAGUE_QUALIFIERS, UEFA_EUROPA_LEAGUE_QUALIFIERS, UEL. sportID: SOCCER - [Tennis Odds API](https://sockodds.com/sports/tennis-odds-api/): Leagues: ATP, WTA. sportID: TENNIS --- ## League coverage 34 leagues covered. Full index: https://sockodds.com/leagues/ ### Aussie Rules - [AFL Odds API](https://sockodds.com/leagues/afl-odds-api/): leagueID: AFL. 6 events, 39 market families, 17 bookmakers. - [AFLW Odds API](https://sockodds.com/leagues/aflw-odds-api/): leagueID: AFLW. 9 events, 40 market families, 12 bookmakers. ### Baseball - [MLB Odds API](https://sockodds.com/leagues/mlb-odds-api/): leagueID: MLB. 85 events, 85 market families, 20 bookmakers. ### Basketball - [NBA Odds API](https://sockodds.com/leagues/nba-odds-api/): leagueID: NBA. 1 events, 36 market families, 7 bookmakers. ### Cricket - [IPL Odds API](https://sockodds.com/leagues/ipl-odds-api/): leagueID: IPL. 5 events, 28 market families, 11 bookmakers. ### American Football - [NFL Odds API](https://sockodds.com/leagues/nfl-odds-api/): leagueID: NFL. 130 events, 12 market families, 18 bookmakers. ### Ice Hockey - [NHL Odds API](https://sockodds.com/leagues/nhl-odds-api/): leagueID: NHL. 1 events, 27 market families, 11 bookmakers. ### MMA - [UFC Odds API](https://sockodds.com/leagues/ufc-odds-api/): leagueID: UFC. 54 events, 4 market families, 11 bookmakers. ### Motorsports - [Formula 1 Odds API](https://sockodds.com/leagues/f1-odds-api/): leagueID: F1. 3 events, 100 market families, 9 bookmakers. ### Rugby League - [NRL Odds API](https://sockodds.com/leagues/nrl-odds-api/): leagueID: NRL. 16 events, 14 market families, 14 bookmakers. - [NRLW Odds API](https://sockodds.com/leagues/nrlw-odds-api/): leagueID: RUGBYLEAGUE_NRLW. 9 events, 16 market families, 5 bookmakers. - [State of Origin Odds API](https://sockodds.com/leagues/state-of-origin-odds-api/): leagueID: RUGBYLEAGUE_STATE_ORIGIN. 1 events, 14 market families, 1 bookmakers. ### Rugby Union - [Rugby Union Internationals Odds API](https://sockodds.com/leagues/rugby-union-internationals-odds-api/): leagueID: RUGBYUNION_INTERNATIONALS. 8 events, 15 market families, 14 bookmakers. ### Soccer - [Brasileiro Série A Odds API](https://sockodds.com/leagues/br-serie-a-odds-api/): leagueID: BR_SERIE_A. 19 events, 23 market families, 9 bookmakers. - [Bundesliga Odds API](https://sockodds.com/leagues/bundesliga-odds-api/): leagueID: BUNDESLIGA. 27 events, 24 market families, 15 bookmakers. - [Premier League Odds API](https://sockodds.com/leagues/epl-odds-api/): leagueID: EPL. 39 events, 28 market families, 20 bookmakers. - [FIFA World Cup Odds API](https://sockodds.com/leagues/fifa-world-cup-odds-api/): leagueID: FIFA_WORLD_CUP. 1 events, 24 market families, 9 bookmakers. - [Ligue 1 Odds API](https://sockodds.com/leagues/fr-ligue-1-odds-api/): leagueID: FR_LIGUE_1. 27 events, 24 market families, 18 bookmakers. - [Iceland 1. deild Odds API](https://sockodds.com/leagues/iceland-1-deild-odds-api/): leagueID: ICELAND_1_DEILD. 1 events, 9 market families, 2 bookmakers. - [Besta deild Odds API](https://sockodds.com/leagues/iceland-besta-deild-odds-api/): leagueID: ICELAND_BESTA_DEILD. 3 events, 10 market families, 2 bookmakers. - [Serie A Odds API](https://sockodds.com/leagues/it-serie-a-odds-api/): leagueID: IT_SERIE_A. 33 events, 24 market families, 16 bookmakers. - [La Liga Odds API](https://sockodds.com/leagues/la-liga-odds-api/): leagueID: LA_LIGA. 41 events, 24 market families, 18 bookmakers. - [MLS Odds API](https://sockodds.com/leagues/mls-odds-api/): leagueID: MLS. 96 events, 26 market families, 19 bookmakers. - [Scottish Premiership Odds API](https://sockodds.com/leagues/scottish-premiership-odds-api/): leagueID: SCOTTISH_PREM. 6 events, 18 market families, 2 bookmakers. - [Slovak 2. Liga Odds API](https://sockodds.com/leagues/slovak-2-liga-odds-api/): leagueID: SLOVAK_2_LIGA. 1 events, 8 market families, 2 bookmakers. - [Slovak Super Liga Odds API](https://sockodds.com/leagues/slovak-super-liga-odds-api/): leagueID: SLOVAK_SUPER_LIGA. 2 events, 14 market families, 2 bookmakers. - [Champions League Odds API](https://sockodds.com/leagues/uefa-champions-league-odds-api/): leagueID: UCL. 17 events, 109 market families, 14 bookmakers. - [Conference League Odds API](https://sockodds.com/leagues/uefa-conference-league-odds-api/): leagueID: UECL. 1 events, 109 market families, 10 bookmakers. - [Champions League Qualifiers Odds API](https://sockodds.com/leagues/uefa-champions-league-qualifiers-odds-api/): leagueID: UEFA_CHAMPIONS_LEAGUE_QUALIFIERS. 5 events, 16 market families, 2 bookmakers. - [Conference League Qualifiers Odds API](https://sockodds.com/leagues/uefa-conference-league-qualifiers-odds-api/): leagueID: UEFA_CONFERENCE_LEAGUE_QUALIFIERS. 19 events, 14 market families, 2 bookmakers. - [Europa League Qualifiers Odds API](https://sockodds.com/leagues/uefa-europa-league-qualifiers-odds-api/): leagueID: UEFA_EUROPA_LEAGUE_QUALIFIERS. 8 events, 16 market families, 2 bookmakers. - [Europa League Odds API](https://sockodds.com/leagues/uefa-europa-league-odds-api/): leagueID: UEL. 2 events, 92 market families, 9 bookmakers. ### Tennis - [ATP Odds API](https://sockodds.com/leagues/atp-odds-api/): leagueID: ATP. 12 events, 3 market families, 19 bookmakers. - [WTA Odds API](https://sockodds.com/leagues/wta-odds-api/): leagueID: WTA. 4 events, 3 market families, 20 bookmakers. --- ## Bookmaker coverage 25 bookmakers covered, 21 of them Australian. Each bookmaker page includes the bookmakerID, coverage details, supported leagues, lanes and integration notes. Full index: https://sockodds.com/bookmakers/ ### Australian bookmakers - [Sportsbet Odds API](https://sockodds.com/bookmakers/sportsbet-odds-api/): bookmakerID: sportsbet (Australia) - [Unibet Odds API](https://sockodds.com/bookmakers/unibet-odds-api/): bookmakerID: unibet (Australia) - [TAB Odds API](https://sockodds.com/bookmakers/tab-odds-api/): bookmakerID: tab (Australia) - [PlayUp Odds API](https://sockodds.com/bookmakers/playup-odds-api/): bookmakerID: playup (Australia) - [TABtouch Odds API](https://sockodds.com/bookmakers/tabtouch-odds-api/): bookmakerID: tabtouch (Australia) - [BetRight Odds API](https://sockodds.com/bookmakers/betright-odds-api/): bookmakerID: betright (Australia) - [Neds Odds API](https://sockodds.com/bookmakers/neds-odds-api/): bookmakerID: neds (Australia) - [Picklebet Odds API](https://sockodds.com/bookmakers/picklebet-odds-api/): bookmakerID: picklebet (Australia) - [PointsBet Odds API](https://sockodds.com/bookmakers/pointsbet-odds-api/): bookmakerID: pointsbet (Australia) - [BetDeluxe Odds API](https://sockodds.com/bookmakers/betdeluxe-odds-api/): bookmakerID: betdeluxe (Australia) - [betr (sportsbook) Odds API](https://sockodds.com/bookmakers/betrsportsbook-odds-api/): bookmakerID: betrsportsbook (Australia) - [BetFocus Odds API](https://sockodds.com/bookmakers/betfocus-odds-api/): bookmakerID: betfocus (Australia) - [MintBet Odds API](https://sockodds.com/bookmakers/mintbet-odds-api/): bookmakerID: mintbet (Australia) - [Ladbrokes Odds API](https://sockodds.com/bookmakers/ladbrokes-odds-api/): bookmakerID: ladbrokes (Australia) - [SwiftBet Odds API](https://sockodds.com/bookmakers/swiftbet-odds-api/): bookmakerID: swiftbet (Australia) - [betr Odds API](https://sockodds.com/bookmakers/betr-odds-api/): bookmakerID: betr (Australia) - [CrownBet Odds API](https://sockodds.com/bookmakers/crownbet-odds-api/): bookmakerID: crownbet (Australia) - [bet365 Odds API](https://sockodds.com/bookmakers/bet365-odds-api/): bookmakerID: bet365 (Australia) - [Epic Odds Odds API](https://sockodds.com/bookmakers/epicodds-odds-api/): bookmakerID: epicodds (Australia) ### International and sharp bookmakers - [Pinnacle Odds API](https://sockodds.com/bookmakers/pinnacle-odds-api/): bookmakerID: pinnacle ### Betting exchanges and prediction markets - [Polymarket Odds API](https://sockodds.com/bookmakers/polymarket-odds-api/): bookmakerID: polymarket - [Kalshi Odds API](https://sockodds.com/bookmakers/kalshi-odds-api/): bookmakerID: kalshi - [ProphetX Odds API](https://sockodds.com/bookmakers/prophetexchange-odds-api/): bookmakerID: prophetexchange - [Betfair Exchange Odds API](https://sockodds.com/bookmakers/betfairexchange-odds-api/): bookmakerID: betfairexchange (Australia) ### Pick'em and DFS platforms - [Dabble Odds API](https://sockodds.com/bookmakers/dabble-odds-api/): bookmakerID: dabble (Australia) --- ## Use cases — what you can build 14 use cases for the API — what developers build with it. Each page includes the problem, the relevant endpoints and fields, a code example, a comparison table, and FAQs. Full index: https://sockodds.com/use-cases/ ### Betting Tools - [Odds API for Arbitrage Betting](https://sockodds.com/use-cases/arbitrage-betting-api/): 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 & Line Shopping API](https://sockodds.com/use-cases/odds-comparison-api/): Compare bookmaker odds with one API call. SockOdds returns every book's price under byBookmaker, a consensus line, and click-to-bet deeplinks. - [Odds API for Positive EV Betting](https://sockodds.com/use-cases/positive-ev-betting-api/): 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. ### Apps & Products - [Live & In-Play Betting Odds API](https://sockodds.com/use-cases/live-in-play-odds-api/): Pre-match lines and live event status across every Australian book, refreshed every couple of minutes, with the honest flags a live product needs. - [Odds API for Parlay Builders](https://sockodds.com/use-cases/parlay-builder-api/): 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. - [Sports Odds API for Betting Apps](https://sockodds.com/use-cases/sports-betting-app-api/): The sports betting app API with odds from every major Australian bookmaker, event status, results, and click-to-bet deeplinks in a single feed. ### Data & Models - [Odds API for Bet Tracking & Settlement](https://sockodds.com/use-cases/bet-tracking-settlement-api/): 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 API: Player Props & Projections for Lineup Tools](https://sockodds.com/use-cases/dfs-data-api/): 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 API](https://sockodds.com/use-cases/historical-odds-data-api/): Finished events are never pruned from the feed, so an odds archive of every Australian book starts the day you start pulling. - [Odds Data API for Sports Betting Models & Backtesting](https://sockodds.com/use-cases/sports-betting-machine-learning/): 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. ### Bots & Side Projects - [Odds API for Betting Alert Bots](https://sockodds.com/use-cases/odds-alert-bot-api/): 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. - [Sports Odds API for AI Agents & MCP](https://sockodds.com/use-cases/sports-odds-api-mcp-ai-agents/): Add live Australian odds to AI agents with the SportsGameOdds MCP server pointed at SockOdds, the five SGO SDKs, and LLM-ready docs. ### Media & Content - [Live Scores & Sports Data API](https://sockodds.com/use-cases/live-scores-sports-data-api/): Event status, results and team data across every code Australia follows, with odds in the same schema. ### Prediction Markets - [Odds API for Prediction Market Arbitrage](https://sockodds.com/use-cases/prediction-market-arbitrage-api/): Compare Kalshi and Polymarket prices against Australian sportsbook odds in one schema. Find exchange-vs-book arbitrage in one odds API. --- ## Blog — tutorials, guides, and insights 16 articles covering integration guides, use cases, comparisons, and educational content, grouped by topic. Full index: https://sockodds.com/blog/ ### Odds API - [SockOdds: the Australian extension of the SportsGameOdds schema](https://sockodds.com/blog/sockodds-the-australian-extension-of-sportsgameodds/): Why SockOdds speaks SportsGameOdds v2 unchanged, what it adds (every Australian book, AFL, NRL, cricket, rugby), and how to point an existing SGO integration at it in one line. - [Getting Started with the SockOdds API](https://sockodds.com/blog/getting-started-with-the-sockodds-api/): Whether you're building a sportsbook comparison, a fantasy tool, a betting model or an analytics dashboard, here is the shortest path from a free key to Australian odds in your code. - [How the Odds API Handles Postponed, Delayed, Cancelled and Stale Events](https://sockodds.com/blog/postponed-delayed-cancelled-events-odds-api/): What the status flags mean, why a stale event is flagged rather than refreshed, and how to reconcile a rescheduled fixture in your own data. ### Odds API Guide - [What Are Consensus Odds and How SockOdds Calculates Them](https://sockodds.com/blog/consensus-odds-calculation/): bookOdds is the consensus with the vig in; fairOdds is the exchange-and-sharp-book price with the vig out. How each is derived and what fairOddsAvailable tells you. - [Common Odds API Questions, Answered for Australia](https://sockodds.com/blog/common-odds-api-questions/): What an odds API is, what Australian coverage actually means, decimal vs American prices, legality, and how the free tier works. ### AFL Odds API - [How to Query AFL Odds and Player Props](https://sockodds.com/blog/afl-odds-api-guide/): A walkthrough of the /v2/events endpoint using the AFL as the example: basic requests, filtering player props with oddID, and the parameters that keep responses fast. - [Every AFL Betting Market in the SockOdds API](https://sockodds.com/blog/afl-betting-markets-api/): A complete reference to every AFL betting market in the feed: game lines, quarter and half markets and player props, each with its exact oddID and the bookmakers pricing it. ### NRL Odds API - [How to Query NRL Odds and Try Scorer Props](https://sockodds.com/blog/nrl-odds-api-guide/): Querying NRL, NRLW and State of Origin from the events endpoint: the RUGBYLEAGUE_ league keys, try-scorer oddIDs and margin markets. - [Every NRL Betting Market in the SockOdds API](https://sockodds.com/blog/nrl-betting-markets-api/): A complete reference to every NRL market in the feed: head to head, line, total, winning margin, halves and try-scorer props, with oddIDs and bookmakers. ### Cricket Odds API - [Cricket Odds API Guide: IPL Markets, Top Batter and Top Bowler](https://sockodds.com/blog/cricket-odds-api-guide/): How cricket is modelled in the SGO grammar: innings periods, top batter and top bowler bet types, sixes, fours, wickets and method of dismissal. ### Player Prop Odds API - [Player Prop Odds API Guide for Australian Sports](https://sockodds.com/blog/player-prop-odds-api-guide/): How player props are keyed (the playerID slot in the oddID), how to pull one prop type across every player with PLAYER_ID, and what the AU books actually price. ### Prediction Market API - [Kalshi and Polymarket Prices Next to Australian Bookmakers](https://sockodds.com/blog/prediction-market-api-guide/): Prediction markets are in the same byBookmaker object as the sportsbooks. What that enables, and how to compare a contract price to a book price. ### Sports Betting API - [Every Premier League Betting Market in the SockOdds API](https://sockodds.com/blog/epl-betting-markets-api/): Premier League markets as priced by Australian bookmakers: 1X2, Asian lines, BTTS, correct score, cards, corners and goalscorer props, with oddIDs. - [Every MLB Betting Market in the SockOdds API](https://sockodds.com/blog/mlb-betting-markets-api/): MLB from the Australian books: run lines, first-five markets, inning lines and batting and pitching props, each with its exact oddID. - [Australian Bookmakers in One Odds API: Sportsbet, TAB, Ladbrokes, Neds and the rest](https://sockodds.com/blog/australian-bookmakers-odds-api/): Which Australian bookmakers the feed prices, how many events each covers, which carry bet-slip deeplinks, and how lanes like pick'em and same-game multi are keyed. ### Vibe Coding - [AI-Assisted Development with the SockOdds API](https://sockodds.com/blog/vibe-coding-odds-api/): Use Claude Code, Cursor or Copilot against SockOdds: the SGO MCP server pointed at our base URL, llms.txt, and a copy-paste context block. --- ## Additional website pages Pages not included in the main llms.txt orientation file. - [Partner / affiliate program](https://sockodds.com/partner/): Revenue share for developers and content creators who refer customers to SockOdds. - [Terms of service](https://sockodds.com/terms/): Full terms governing API usage and commercial applications. - [Privacy policy](https://sockodds.com/privacy/): Data handling and privacy practices. - [Postman collection](https://sockodds.com/postman-collection/): Every endpoint as an importable collection, with the apiKey variable prefilled. - [Account](https://sockodds.com/account/): Key, plan and usage for an existing customer. --- ## Frequently asked questions **What is an odds API?** An odds API is a programmatic interface that delivers sports betting odds — head-to-head, lines, totals and player props — from bookmakers straight into your app. Unlike a sports stats API, an odds API is about bookmaker prices. SockOdds delivers every Australian bookmaker's prices through one REST API, with event status, results and bet-slip deeplinks included. **What is SockOdds?** SockOdds is the Australian extension of the SportsGameOdds schema: a REST API serving odds, event status, results and deeplinks from 21 Australian bookmakers plus the exchanges and prediction markets that anchor fair prices, across 34 leagues and 12 sports. The paths, envelope and oddID grammar are SportsGameOdds v2, so anything written for SGO runs here by changing the base URL. **What sports, leagues and bookmakers do you cover?** 34 leagues across 12 sports — AFL, AFLW, NRL, NRLW, State of Origin, rugby union internationals, the IPL, plus the NFL, NBA, MLB, NHL, UFC, F1, the Premier League, the Champions League and more — with odds from 21 Australian books including Sportsbet, TAB, Ladbrokes, Neds, PointsBet, Unibet and bet365. Browse sports → Browse leagues → Browse bookmakers → **Does the API include sharp bookmakers like Pinnacle?** Yes. Pinnacle, the Betfair Exchange and ProphetX sit in the same byBookmaker object as the Australian books, and Kalshi and Polymarket prediction-market prices ride along where they price a fixture. Those are the sources the fair price is derived from. **What types of betting data do you provide?** Pre-match odds across every major bet type: head to head, lines, totals, 1X2, player props, team props, alternate lines and more — for full game, halves, quarters, innings and other periods. Every event also carries status flags, results where the source has them, consensus odds with the vig removed on Base and above, and bet-slip deeplinks to the bookmaker. **How accurate and fast is your odds data?** Prices are read from the bookmakers' own public pricing every couple of minutes and joined across books on shared event and market ids. Every bookmaker entry carries lastUpdatedAt; every event carries info.lastUpdatedAt, and an event with no source write for 45 minutes is flagged info.stale: true rather than served as current. **How does your pricing compare to other odds APIs?** Plans are priced on requests per minute and scope, not on how many markets or bookmakers come back. One event with 200 markets across 20 books is one object. Start free, and the Base plan is $69/month with every league and fair odds. See plans & pricing → **Is there a free tier I can start with?** Yes. The Lite plan is free: 10 requests a minute on AFL and NRL with 3 bookmakers and bet-slip deeplinks, no credit card and no expiry — enough to build and evaluate against real games. Sign up free → **How quickly can I integrate the API?** Most developers are up and running in under an hour, and an existing SportsGameOdds integration in minutes: the SGO SDKs for JavaScript, Python, Ruby, Go and Java work unchanged with the base URL pointed here. Quickstart → **How do I get an API key?** Enter an email on the signup page and a Lite key is minted immediately, shown once. Paid plans are set up by contacting us. **How do I authenticate my requests?** Include your key as a header (recommended) — x-api-key: YOUR_API_KEY — or as the query parameter ?apiKey=YOUR_API_KEY. The header keeps your key out of URL logs. **What's the fastest way to make my first API call?** The quickstart has copy-paste examples in cURL, JavaScript, Python, Ruby, PHP and Java. Data explorer → **Do you have SDKs?** Yes — the official SportsGameOdds SDKs (npm install sports-odds-api, pip install sports-odds-api, Ruby, Go and Java) talk to SockOdds unchanged when you set the client's base URL to https://api.sockodds.com/v2. Auto-pagination, typing, retries and error handling all carry over. SDK documentation → **Do you have a Postman collection?** Yes. Download the Postman collection → **Can I use the API in my frontend/browser?** Not recommended — it exposes your key. Proxy calls through a backend, or sync the feed into your own database and query that from the frontend. Best practices → **Do you provide live/in-play odds?** The feed is pre-match first. status.live, status.started and the period flags ride along so a live product knows the state of the game, and you can filter with live=true, but in-play prices refresh on the same ~2 minute cadence as everything else and are not the product. **Do you support player props?** Yes — 188 distinct player-prop markets are priced right now, from AFL disposals and goalscorers to NRL try scorers, MLB hits and Premier League shots. Props come back from the same events request as game lines, keyed by the production SGO playerID. Player Props API → **Do you provide alternate lines?** Yes, where a book prices them. Add includeAltLines=true to an events request and each market's altLines object lists every line with its own byBookmaker. Alt lines multiply the payload, so only ask when you need them. **Does your API include scores, stats and game results?** Event status (started, ended, live, cancelled, finalized, current period) is on every event, and results carries the source's scores and stat values where it has them. Every market carries scoringSupported so you know which can be graded from results. **Do you have deeplinks to bookmakers?** Yes. 273 of the 692 current events carry links.bookmakers (the event on the book's site) and links.betslip (a documented strategy for landing on the selection). They come from each book's own event ids, not reconstructed URLs. **Do you offer historical odds data?** Finished events are never pruned, so your archive of every Australian book's prices starts the day you start pulling (retention began 2026-09). Opening and closing prices are not snapshotted yet — includeOpenCloseOdds is accepted for compatibility but returns nothing. Historical odds → **Do you offer futures or outright markets?** A handful of season markets appear where the source carries them (F1 championship and constructor markets under periodID=season), but season-long markets are not a product line yet. **How do I see what markets are available for a given league?** Use the /markets endpoint — it returns every oddID priced right now with the leagues and bookmakers pricing it, and defaults to isSupported=true. Markets documentation → **Do you offer a Prediction Markets API?** Yes. Kalshi and Polymarket are part of the same unified feed rather than a separate product — their prices sit alongside the sportsbooks in the same byBookmaker object, keyed by bookmakerID. Prediction Market API → **What are "objects" and "requests"?** A request is counted each time you call the API, whatever comes back. An object is a top-level item in the response — ten events is ten objects. Unlike APIs that charge per market and per bookmaker, one event with all its markets and books is one object. Objects are also called entities in the /account/usage response. **How many "objects" or "requests" do I need?** A few hundred to a few thousand objects for local development; tens of thousands for a personal project; hundreds of thousands for a production app; millions for a product syncing every league every couple of minutes. Check /account/usage to see where you stand. **Why is SockOdds cheaper than competitors?** The plans are priced on request rate and scope rather than on the volume of markets and bookmakers you pull, so fetching every AU book on every market never multiplies your bill. **What are the rate limits for each plan?** Lite: 10 requests per minute. Base: 60. Platform: 600. The per-minute counter is atomic — 60 simultaneous calls on a 10/min key serve exactly 10 — and a rejected call is still counted but never billed. Rate limiting details → Compare plans → **When does my monthly object limit reset?** There is no monthly object cap on any plan; the per-minute rate is the limit that matters day to day. Daily object counts are reported in /account/usage for your own tracking. **What happens if I exceed my rate limit?** You receive 429 Too Many Requests with a Retry-After header in seconds. Wait, check /account/usage, use filters to reduce what you fetch, or upgrade if you hit it consistently. **How do I check my current usage?** Call /v2/account/usage, or paste your key on the account page, which calls the same endpoint from your browser. **How do I upgrade, downgrade, cancel or update my billing?** Email api@sockodds.com with your keyID or use the subscription form. Plans are month to month; the free key never expires. Manage account → **What is an oddID?** The unique identifier for one side of one market: {statID}-{statEntityID}-{periodID}-{betTypeID}-{sideID}, e.g. points-home-game-ml-home. Odds data type → **What's the difference between fairOdds and bookOdds?** bookOdds is the consensus across the books pricing the side with the vig left in. fairOdds is the de-vigged price derived from the exchanges and sharp books where they price the market; fairOddsAvailable tells you whether that was possible. Consensus odds → **What are the different bet types (betTypeID)?** The main ones are ml (head to head), sp (line), ou (total), ml3way (1X2), yn (yes/no) and eo (even/odd), plus cricket-specific topbat, topbowl and dismissal. Bet types → **What does statEntityID mean?** Whose stat is being measured: home, away, all (both teams combined), or a specific playerID for props. Stat entities → **What are the different periodIDs?** game, reg, halves (1h, 2h), quarters (1q–4q), periods (1p–3p), innings (1i–8i, 1ix5), cricket overs (1ov, 6ov_cum) and season. Periods → **Why does "points" mean different things in different sports?** points is the statID that decides the event in every sport — runs in baseball and cricket, goals in soccer and hockey, sets in tennis — so a total or a line reads the same way across every league. **How do I use pagination (cursor)?** Pass the nextCursor from one response as cursor on the next, keeping every other parameter the same, until nextCursor is null. Pagination → **How do I optimize API response times?** Filter at the API: one league at a time, oddID for the markets you need, bookmakerID for the books you show, and leave includeAltLines off unless you need it. Response speed → **How often should I poll for odds updates?** The source refreshes every ~2 minutes, so polling faster is wasted quota. Poll every 2–5 minutes for the fixtures you care about and cache by info.lastUpdatedAt. **How does the real-time streaming API work?** It doesn't, yet — /v2/stream/events answers 501 so an SGO client fails loudly instead of waiting on a socket. The streaming guide shows the polling-and-diff pattern that replaces it. **Why are my filters ignored when I pass eventID?** By design: with eventID or eventIDs only those ids are used; response-shaping parameters (oddID, bookmakerID, includeAltLines) still apply. **Do I need sportID if I already have leagueID?** No. Each league belongs to exactly one sport, so sportID is redundant when leagueID is set. **How do I get team colors?** On the teams object under colors, where the source carries them (many Australian sources don't yet, in which case the fields are empty strings). **Does the cancelled flag work at the event level or the odds level?** Both exist. Use status.cancelled on the event; the odds-level flag describes the period the market settles on. **How do I grade or settle a bet from the API?** When status.finalized is true, read the stat at results.{periodID}.{statEntityID}.{statID} for the market's grammar and compare it to the line. scoringSupported says whether the source can grade that market. Handling odds → **Why am I getting a 401 error?** The key is missing, mistyped, has leading/trailing whitespace, or has been deactivated. Send it as x-api-key (case-insensitive) or apiKey. **Why am I getting a 403 error?** The key exists but has been deactivated. Email support with the keyID. **Why am I getting a 429 error?** You've exceeded your per-minute limit. The response carries Retry-After; the rejected call is still counted for the minute but never billed. **Why am I seeing an odds value like -10000?** That is a real last-seen price from the book, usually on a side that has effectively settled. Check available and lastUpdatedAt before acting on it. **What happens when a game is postponed, delayed or cancelled?** status.delayed and status.cancelled flip, status.previousStartsAt keeps the earlier kick-off times, and if the source stops writing the event is flagged info.stale after 45 minutes. Read more → **How should I handle errors in my code?** Retry 5xx once after a short delay with jitter; never retry 4xx except 429 after Retry-After. Every error body carries success: false and an error string. Errors → **What if I need a league or bookmaker you don't currently support?** Tell us. Coverage is driven by the same pipeline that prices Australian markets, and most additions the source can reach land within a couple of weeks. **Do you cover racing or esports?** Not in this feed. Horse and greyhound racing are deliberately out of scope; esports prices appear only where a covered book carries them on a covered league. **Do you offer custom or enterprise plans?** Yes — the Platform plan is a dedicated key per environment with no bookmaker cap and the highest request rate. Talk to us → **Can I get a bulk or annual discount?** Annual billing on Base is 10 months for twelve. Volume pricing on Platform is agreed per customer. **Do you offer real-time streaming or webhook-style updates?** Not yet. Polling every ~2 minutes matches the source cadence; the streaming endpoint is reserved for when the source can push. **How do I report a data issue or request a feature?** Email api@sockodds.com with the full request URL, the response and what you expected. Typical response within one business day. **What level of support do you provide?** Email support on every plan; paid plans are prioritised; Platform customers get a direct channel. Contact us → **Do you have an affiliate or partner program?** Yes — a referral program for developers and content creators who bring customers to SockOdds. Partner program → **Is the commission recurring?** Yes, for as long as the referred customer stays subscribed. The rate is set out when you join. **How do I get my referral link?** Apply on the partner page; you receive a link and a dashboard when approved. **How should I promote SockOdds?** Blog posts, forums, videos, podcasts, newsletters — anywhere developers building on Australian odds are. Honest promotion only: no misleading claims, spam or brand bidding. **How do I track my earnings and referrals?** Your dashboard shows clicks, referrals, conversions and earnings. --- ## Odds API provider comparison (September 2026) Figures for other providers are SportsGameOdds' June 2026 verification; a dash means the provider does not publish that figure. | Provider | Australian books | Bookmakers | Sharp/Exchanges | Free tier | Pricing | Streaming | Settlement | | --- | --- | --- | --- | --- | --- | --- | --- | | SockOdds | 21 with deeplinks | 25 | Pinnacle, Betfair Exchange, ProphetX, Kalshi, Polymarket | Yes — no card | Public: free / $69 / custom | Polling (~2 min) | Status + results where sourced | | The Odds API | An AU region with the major Australian brands; no AU bet-slip links | 40+ brands (own count) | Pinnacle (EU only, scraped, may lag) | 500 credits/mo, no card | Per credit: markets × regions per call, $0–$249/mo | REST only | Scores only | | OpticOdds | Not published | 100–200+ (docs vs marketing) | Exchanges; Pinnacle as internal reference | None public (sales trial) | Contact — reported $499–$5,000+/mo per sport | SSE | Yes (auto-grader) | | SportsDataIO | US-only sportsbooks | Not published (regulated US books) | No | Trial only | Contact | REST | Yes (verification) | | Unabated | US market-makers; no Australian books | ~25 (reported) | Yes — market-makers and a vig-free Unabated Line | No | Sales-gated, from $3,000/mo | WebSocket + SSE | Unknown | | TheRundown | Not published | 18+ (vendor-claimed) | Claimed (Pinnacle, LowVig, Matchbook) | $0, 20k points/day (claimed) | Public, $0–$2,499/mo | WebSocket (Ultra+) | Partial | | Sportradar | Official-data partnerships; enterprise only | 400+ (reported) | Exchanges reported; Pinnacle not named | 30-day trial, 1,000 requests | Contact — reported $10,000+/mo | REST (15–30 s) | Unknown | Best odds API by use case: The Odds API if you want the cheapest entry credits or futures/outrights; OpticOdds if you are an operator or trading desk with a budget for an enterprise contract; SportsDataIO if you need licensed all-in-one US stats and odds; Unabated if your edge is US sharp/CLV work at a professional budget; TheRundown if you want a US-centric feed with a points-based free tier; Sportradar if you need officially licensed data at enterprise scale; SockOdds if you need Australian bookmakers, AFL, NRL, cricket or rugby in the SportsGameOdds schema. Full comparison and head-to-head pages: https://sockodds.com/compare/ --- ## Glossary **Head to head (H2H)** — the moneyline. betTypeID: ml. **Line** — the spread/handicap. betTypeID: sp. **Total (O/U)** — over/under. betTypeID: ou. **Multi** — a parlay. **SGM** — same-game multi, priced in the *_sgm_only lanes. **Juice / vig** — the bookmaker's margin; fairOdds removes it. **Player prop** — statEntityID = playerID. **Consensus odds** — bookOdds (vig in). **Fair odds** — fairOdds (vig out, from exchange/sharp sources). **Implied probability** — 1 / decimal. **Alt lines** — includeAltLines=true. **Partial game markets** — periodID 1h, 2h, 1q–4q, 1i, 1ix5, 1ov, … **Deeplink** — links.bookmakers and links.betslip on the event. **oddID format** — statID-statEntityID-periodID-betTypeID-sideID. **Stale** — info.stale: no source write for 45 minutes. --- ## Contact - Docs: https://sockodds.com/docs/ - Pricing: https://sockodds.com/pricing/ - Support: https://sockodds.com/docs/help/ - Contact: https://sockodds.com/contact-us/