Football is the world’s most-bet sport. If you’re building anything with betting data \u2014 a model, a scanner, a dashboard \u2014 you need odds from more than 20 bookmakers. You need the sharps. You need Asian Handicaps. And you need it in JSON, not scraped HTML.<\/p>\n
Most APIs cover 40 soft bookmakers and call it a day. OddsPapi covers 140+ bookmakers per match<\/strong>, including Pinnacle, Singbet, and Betfair Exchange \u2014 the books that actually set the market. That’s 1X2, Asian Handicaps (every line), Both Teams To Score, Over\/Under, and 460+ markets total. All on a free tier.<\/p>\n OddsPapi covers 1,372 football tournaments<\/strong> \u2014 from the Premier League, La Liga, Bundesliga, Serie A, and Ligue 1 down to lower divisions, youth leagues, and women’s football. Champions League, Europa League, MLS, Brasileiro Serie A, Eredivisie, Primeira Liga, Scottish Premiership, Turkish Super Lig, and hundreds more.<\/p>\n Coverage extends to every competition that bookmakers price. If a bookmaker prices it, we have it.<\/p>\n Each football fixture on OddsPapi can have 464+ unique markets<\/strong>. Here are the key ones with their market IDs \u2014 you’ll need these for API calls:<\/p>\n Asian Handicaps are how sharps bet football. Each line has its own market ID \u2014 not one generic “Asian Handicap” market. This means you can compare Pinnacle’s -0.5 line directly against Bet365’s -0.5 line, or track how the -1.0 line moves across 24 bookmakers independently.<\/p>\n Other APIs collapse these into a single market or don’t cover them at all. OddsPapi gives you every line (from +0.5 through -1.5 and beyond) as a distinct, queryable market.<\/p>\n This is where it gets interesting for sharps. Pull Asian Handicap -0.5 odds from every bookmaker and compare:<\/p>\n This is where the edge lives. Soft bookmakers are slow to adjust Asian Handicap lines. Pinnacle moves first. If you can spot when Bet365’s -0.5 is still 1.95 but Pinnacle has already moved to 1.85, you’ve found value.<\/p>\n Need to backtest your football model? Check Closing Line Value? Analyze how Asian Handicap lines moved before kickoff?<\/p>\n OddsPapi includes historical odds on the free tier<\/strong>. Pull past odds for any fixture, any bookmaker, any market. Most APIs charge extra for historical data \u2014 or lock it behind enterprise plans. We include it free because backtesting is how you build models that actually work.<\/p>\nFootball Odds Coverage: OddsPapi vs The Competition<\/h2>\n
\n\n
\n \nFeature<\/th>\n The Odds API<\/th>\n SportsGameOdds<\/th>\n OddsPapi<\/th>\n<\/tr>\n<\/thead>\n \n Bookmakers per match<\/td>\n ~15-20<\/td>\n ~30<\/td>\n 140+<\/strong><\/td>\n<\/tr>\n \n Sharp books (Pinnacle, Singbet)<\/td>\n No<\/td>\n No<\/td>\n Yes<\/strong><\/td>\n<\/tr>\n \n Asian Handicap markets<\/td>\n Limited<\/td>\n Limited<\/td>\n Full (every line)<\/strong><\/td>\n<\/tr>\n \n Over\/Under lines<\/td>\n 2.5 only<\/td>\n Some<\/td>\n 1.5, 2.5, 3.5+<\/strong><\/td>\n<\/tr>\n \n BTTS market<\/td>\n Yes<\/td>\n Yes<\/td>\n Yes (109+ books)<\/strong><\/td>\n<\/tr>\n \n Tournaments<\/td>\n ~30 leagues<\/td>\n ~50 leagues<\/td>\n 1,372 tournaments<\/strong><\/td>\n<\/tr>\n \n Betfair Exchange<\/td>\n No<\/td>\n No<\/td>\n Yes<\/strong><\/td>\n<\/tr>\n \n Free tier<\/td>\n 500 req\/mo<\/td>\n Limited<\/td>\n 250 req\/mo<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n 1,372 Tournaments, Every League That Matters<\/h2>\n
Football Markets: From 1X2 to Asian Handicaps<\/h2>\n
\n\n
\n \nMarket<\/th>\n Market ID<\/th>\n Outcomes<\/th>\n Books<\/th>\n<\/tr>\n<\/thead>\n \n Full Time Result (1X2)<\/td>\n 101<\/td>\n Home (101), Draw (102), Away (103)<\/td>\n 125+<\/td>\n<\/tr>\n \n Both Teams To Score<\/td>\n 104<\/td>\n Yes (104), No (105)<\/td>\n 109+<\/td>\n<\/tr>\n \n Over\/Under 2.5 Goals<\/td>\n 1010<\/td>\n Over (1010), Under (1011)<\/td>\n 119+<\/td>\n<\/tr>\n \n Over\/Under 1.5 Goals<\/td>\n 1012<\/td>\n Over (1012), Under (1013)<\/td>\n 101+<\/td>\n<\/tr>\n \n Over\/Under 3.5 Goals<\/td>\n 1014<\/td>\n Over (1014), Under (1015)<\/td>\n 98+<\/td>\n<\/tr>\n \n Asian Handicap -0.5<\/td>\n 1068<\/td>\n Home (1068), Away (1069)<\/td>\n 53<\/td>\n<\/tr>\n \n Asian Handicap 0<\/td>\n 1072<\/td>\n Home (1072), Away (1073)<\/td>\n 22<\/td>\n<\/tr>\n \n Asian Handicap -1<\/td>\n 1064<\/td>\n Home (1064), Away (1065)<\/td>\n 24<\/td>\n<\/tr>\n \n Asian Handicap +0.5<\/td>\n 1076<\/td>\n Home (1076), Away (1077)<\/td>\n 30<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n Why Asian Handicaps Matter<\/h3>\n
Python Tutorial: Football Odds in 5 Steps<\/h2>\n
Step 1: Setup<\/h3>\n
import requests\nfrom datetime import datetime, timedelta\n\nAPI_KEY = \"YOUR_API_KEY\" # Free at oddspapi.io\nBASE_URL = \"https:\/\/api.oddspapi.io\/v4\"\nSPORT_ID = 10 # Soccer\/Football<\/code><\/pre>\nStep 2: Browse Tournaments<\/h3>\n
def get_tournaments():\n \"\"\"Get all football tournaments.\"\"\"\n response = requests.get(f\"{BASE_URL}\/tournaments\", params={\n \"apiKey\": API_KEY,\n \"sportId\": SPORT_ID\n })\n tournaments = response.json()\n print(f\"{len(tournaments)} tournaments available\")\n return tournaments\n\ntournaments = get_tournaments()\n\n# Filter to top leagues\nfor t in tournaments:\n if any(name in t.get(\"tournamentName\", \"\") for name in [\"Premier League\", \"La Liga\", \"Bundesliga\", \"Serie A\", \"Champions\"]):\n print(f\" {t['tournamentName']} (ID: {t['tournamentId']})\")<\/code><\/pre>\nStep 3: Get Today’s Fixtures<\/h3>\n
def get_fixtures(sport_id=SPORT_ID):\n \"\"\"Get today's football fixtures with odds.\"\"\"\n today = datetime.now().strftime(\"%Y-%m-%d\")\n tomorrow = (datetime.now() + timedelta(days=1)).strftime(\"%Y-%m-%d\")\n\n response = requests.get(f\"{BASE_URL}\/fixtures\", params={\n \"apiKey\": API_KEY,\n \"sportId\": sport_id,\n \"from\": today,\n \"to\": tomorrow\n })\n\n fixtures = response.json()\n with_odds = [f for f in fixtures if f.get(\"hasOdds\")]\n print(f\"{len(with_odds)} fixtures with odds today\")\n return with_odds\n\nfixtures = get_fixtures()\nfor f in fixtures[:10]:\n print(f\" {f['participant1Name']} vs {f['participant2Name']} ({f['tournamentName']})\")<\/code><\/pre>\nStep 4: Fetch Odds from 140+ Bookmakers<\/h3>\n
def get_odds(fixture_id):\n \"\"\"Get odds from all bookmakers for a fixture.\"\"\"\n response = requests.get(f\"{BASE_URL}\/odds\", params={\n \"apiKey\": API_KEY,\n \"fixtureId\": fixture_id\n })\n return response.json()\n\n# Pick a fixture and get odds\nfixture = fixtures[0]\nodds = get_odds(fixture[\"fixtureId\"])\nbookmakers = list(odds.get(\"bookmakerOdds\", {}).keys())\nprint(f\"{len(bookmakers)} bookmakers pricing {fixture['participant1Name']} vs {fixture['participant2Name']}\")<\/code><\/pre>\nStep 5: Compare Odds Across Bookmakers<\/h3>\n
def compare_odds(odds_data, market_id=\"101\"):\n \"\"\"Compare odds across all bookmakers for a market.\n\n Market 101 = Full Time Result (1X2)\n Outcomes: 101=Home, 102=Draw, 103=Away\n \"\"\"\n results = []\n\n for slug, bookie in odds_data.get(\"bookmakerOdds\", {}).items():\n market = bookie.get(\"markets\", {}).get(market_id)\n if not market:\n continue\n\n row = {\"bookmaker\": slug}\n for outcome_id, outcome in market.get(\"outcomes\", {}).items():\n for player_id, player in outcome.get(\"players\", {}).items():\n price = player.get(\"price\")\n if outcome_id == \"101\":\n row[\"home\"] = price\n elif outcome_id == \"102\":\n row[\"draw\"] = price\n elif outcome_id == \"103\":\n row[\"away\"] = price\n\n if \"home\" in row:\n results.append(row)\n\n # Sort by best home odds\n results.sort(key=lambda x: x.get(\"home\", 0), reverse=True)\n\n print(f\"\\n1X2 Odds from {len(results)} bookmakers:\")\n print(f\"{'Bookmaker':<20} {'Home':>8} {'Draw':>8} {'Away':>8}\")\n print(\"-\" * 46)\n for r in results[:10]:\n print(f\"{r['bookmaker']:<20} {r.get('home', 'N\/A'):>8} {r.get('draw', 'N\/A'):>8} {r.get('away', 'N\/A'):>8}\")\n\n # Find best prices\n best_home = max(results, key=lambda x: x.get(\"home\", 0))\n best_draw = max(results, key=lambda x: x.get(\"draw\", 0))\n best_away = max(results, key=lambda x: x.get(\"away\", 0))\n\n print(f\"\\nBest Home: {best_home['home']} @ {best_home['bookmaker']}\")\n print(f\"Best Draw: {best_draw['draw']} @ {best_draw['bookmaker']}\")\n print(f\"Best Away: {best_away['away']} @ {best_away['bookmaker']}\")\n\ncompare_odds(odds)<\/code><\/pre>\nAdvanced: Compare Asian Handicap Lines<\/h2>\n
def compare_asian_handicap(odds_data, market_id=\"1068\"):\n \"\"\"Compare Asian Handicap -0.5 across bookmakers.\n\n Market 1068 = Asian Handicap -0.5\n Outcomes: 1068=Home -0.5, 1069=Away +0.5\n \"\"\"\n results = []\n\n for slug, bookie in odds_data.get(\"bookmakerOdds\", {}).items():\n market = bookie.get(\"markets\", {}).get(market_id)\n if not market:\n continue\n\n row = {\"bookmaker\": slug}\n for outcome_id, outcome in market.get(\"outcomes\", {}).items():\n for player_id, player in outcome.get(\"players\", {}).items():\n price = player.get(\"price\")\n if outcome_id == \"1068\":\n row[\"home_minus\"] = price\n elif outcome_id == \"1069\":\n row[\"away_plus\"] = price\n\n if \"home_minus\" in row:\n results.append(row)\n\n results.sort(key=lambda x: x.get(\"home_minus\", 0), reverse=True)\n\n print(f\"\\nAsian Handicap -0.5 from {len(results)} bookmakers:\")\n print(f\"{'Bookmaker':<20} {'Home -0.5':>10} {'Away +0.5':>10}\")\n print(\"-\" * 42)\n for r in results[:10]:\n print(f\"{r['bookmaker']:<20} {r.get('home_minus', 'N\/A'):>10} {r.get('away_plus', 'N\/A'):>10}\")\n\ncompare_asian_handicap(odds)<\/code><\/pre>\nFree Historical Football Odds<\/h2>\n