{"id":5209,"date":"2026-10-26T10:00:00","date_gmt":"2026-10-26T10:00:00","guid":{"rendered":"https:\/\/oddspapi.io\/blog\/?p=5209"},"modified":"2026-10-19T13:40:44","modified_gmt":"2026-10-19T13:40:44","slug":"south-america-sports-betting-api","status":"publish","type":"post","link":"https:\/\/oddspapi.io\/blog\/south-america-sports-betting-api\/","title":{"rendered":"South America Sports Betting API: Rank 247 Books per Fixture"},"content":{"rendered":"

If you need a South America sports betting API, you want the Argentine, Colombian and Peruvian boards as JSON, with the local books next to the global ones. OddsPapi carries 68 South American soccer tournaments in the same schema as the Premier League, and one key reads all of them. On 19 October 2026, between 13:11 and 13:20 UTC, we read 26 open boards across nine tournaments: the median fixture carried 247 bookmakers, and the deepest Argentine board carried 276.<\/p>\n

You also need a reference close for each tournament, the book that settles tightest. We pulled the closing 1X2 on 62 played fixtures from 10 to 19 October. Of the three books we tracked, Pinnacle closed tightest in Argentina, Brazil, Chile, Ecuador, Uruguay and Paraguay. In Peru and Bolivia, the Peruvian book Apuesta Total closed under Pinnacle on all 12 fixtures. This guide pulls the tournaments, ranks every book on each board, and checks the close.<\/p>\n

Why a scraper per country gives you a partial board<\/h2>\n

If you scrape South American books, you maintain one parser per site and one per country, and you still miss most of the board. On the boards we read, the median fixture drew 247 books. Many of them are crypto and offshore sportsbooks, US books and European exchanges that no regional scraper touches. Some of the tightest prices on the board come from those books.<\/p>\n

OddsPapi returns every book in one \/v4\/odds<\/code> call, with a bookmakerFixtureId<\/code> and a fixturePath<\/code> deep link to the event on each book’s own site. The local books ship under their own slugs: apuestatotal<\/code> (Peru), betplay<\/code> and rushbet.co<\/code> (Colombia), betano.pe<\/code>, and the Brazilian licensees that our Brasileir\u00e3o odds API guide<\/a> covers.<\/p>\n

\n\n\n\n\n\n\n\n\n\n
<\/th>\nScrape local sites<\/th>\nOddsPapi<\/th>\n<\/tr>\n<\/thead>\n
Access<\/td>\nNo public odds API, one parser per site<\/td>\nREST and WebSocket, one apiKey<\/code> query parameter<\/td>\n<\/tr>\n
Books per fixture<\/td>\nThe sites you scrape<\/td>\n247 on the median open board we read, 350+ in the catalogue<\/td>\n<\/tr>\n
Tournaments<\/td>\nOne site per country<\/td>\n68 South American soccer tournaments with fixtures loaded<\/td>\n<\/tr>\n
Shared platforms<\/td>\nInvisible<\/td>\nA shared bookmakerFixtureId<\/code> groups the books on one platform<\/td>\n<\/tr>\n
Played fixtures<\/td>\nOnly what your recorder saved<\/td>\n\/v4\/historical-odds<\/code> on the free tier<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n

Step 1: find the South American tournaments<\/h2>\n

Authentication is one query parameter, apiKey<\/code>. The helper waits out a 429 for as long as the error body says, backs off on a 5xx, and returns None<\/code> on a 404. The script reads the soccer catalogue, keeps the ten South American countries and the two CONMEBOL club cups, and picks the biggest competition per country.<\/p>\n

import os, time, requests\nfrom datetime import datetime, timedelta, timezone\nfrom statistics import median\n\nAPI_KEY = os.environ["ODDSPAPI_API_KEY"]\nBASE = "https:\/\/api.oddspapi.io\/v4"\n\ndef get(path, **params):\n    params["apiKey"] = API_KEY\n    for _ in range(8):\n        r = requests.get(f"{BASE}\/{path}", params=params, timeout=180)\n        if r.status_code == 429:                      # rate limited: wait as told\n            time.sleep(r.json().get("error", {}).get("retryMs", 2000) \/ 1000 + 0.5)\n            continue\n        if r.status_code >= 500:                      # transient: back off and retry\n            time.sleep(2)\n            continue\n        if r.status_code == 404:                      # empty window\n            return None\n        r.raise_for_status()\n        return r.json()\n    raise RuntimeError(f"gave up on {path}")\n\nCOUNTRIES = ["Argentina", "Bolivia", "Brazil", "Chile", "Colombia", "Ecuador",\n             "Paraguay", "Peru", "Uruguay", "Venezuela"]\n\ntournaments = get("tournaments", sportId=10)          # soccer\nlive = [t for t in tournaments\n        if (t["categoryName"] in COUNTRIES or t["tournamentName"].startswith("CONMEBOL"))\n        and t["futureFixtures"] > 0]\nprint(f"{len(live)} South American soccer tournaments with fixtures loaded\\n")\n\n# the biggest competition per country, plus the two CONMEBOL club cups\ntop = {}\nfor t in sorted(live, key=lambda t: -t["futureFixtures"]):\n    key = t["tournamentName"] if t["categoryName"] == "International Clubs" else t["categoryName"]\n    if "Women" in t["tournamentName"] or "Reserve" in t["tournamentName"]:\n        continue\n    top.setdefault(key, t)\nfor key, t in sorted(top.items()):\n    print(f'{t["tournamentId"]:>6}  {t["categoryName"]:<19} {t["tournamentName"]:<26} '\n          f'{t["futureFixtures"]:>3} future fixtures')<\/code><\/pre>\n
68 South American soccer tournaments with fixtures loaded\n\n   155  Argentina           Primera LPF                 45 future fixtures\n 33980  Bolivia             Division Profesional        48 future fixtures\n   325  Brazil              Brasileiro Serie A          70 future fixtures\n   384  International Clubs CONMEBOL Libertadores        2 future fixtures\n   480  International Clubs CONMEBOL Sudamericana        2 future fixtures\n 27665  Chile               Primera Division            50 future fixtures\n 27070  Colombia            Liga DIMAYOR                54 future fixtures\n   240  Ecuador             LigaPro Primera A           48 future fixtures\n 27098  Paraguay            Division de Honor           42 future fixtures\n   406  Peru                Liga 1                      45 future fixtures\n   278  Uruguay             Primera Division             8 future fixtures\n 19282  Venezuela           Copa Venezuela               8 future fixtures<\/code><\/pre>\n
Each tournamentId<\/code> is the filter you pass to \/v4\/fixtures<\/code>. The endpoint docs leave it out, but it works and lets you pull a whole month in one call. Venezuela shows its cup because the catalogue had no Venezuelan league fixtures loaded on the day we ran this.<\/p>\n
Step 2: rank every book on the next board in each tournament<\/h2>\n
This step reads the next open board in each tournament and scores every book on the 1X2. A book counts only when the book itself is open and all three legs are active. The script prints four numbers per board: books in the payload, books with a full 1X2, distinct price sets, and the median margin. It then prints the margin and rank of three books that you can use as a reference.<\/p>\n
# Reuses get(), top and the imports from Step 1.\nWATCH = ["pinnacle", "betplay", "apuestatotal"]\n\ndef margin_1x2(book):\n    """1X2 margin in %, or None unless the book is open and all three legs are active."""\n    if book.get("suspended") or book.get("bookmakerIsActive") is False:\n        return None\n    m = book["markets"].get("101")                     # Full Time Result\n    if not m:\n        return None\n    legs = [m["outcomes"].get(o, {}).get("players", {}).get("0") for o in ("101", "102", "103")]\n    if not all(l and l.get("active") and l.get("price") for l in legs):\n        return None\n    return (sum(1 \/ l["price"] for l in legs) - 1) * 100, tuple(l["price"] for l in legs)\n\nnow = datetime.now(timezone.utc)\nwindow = {"from": now.strftime("%Y-%m-%d"),\n          "to": (now + timedelta(days=5)).strftime("%Y-%m-%d")}\nfor key, t in sorted(top.items()):\n    fixtures = get("fixtures", tournamentId=t["tournamentId"], **window) or []\n    time.sleep(1)\n    for f in sorted(fixtures, key=lambda f: f["startTime"]):\n        if (f["statusName"] != "Pre-Game" or not f["hasOdds"]\n                or f["startTime"] <= now.isoformat()):\n            continue\n        board = (get("odds", fixtureId=f["fixtureId"]) or {}).get("bookmakerOdds", {})\n        time.sleep(1)\n        board = {s: b for s, b in board.items() if "+" not in s and s != "demo"}\n        quotes = {s: q for s, b in board.items() if (q := margin_1x2(b)) and q[0] > 0}\n        if len(quotes) >= 20:                          # first board with an open 1X2\n            break\n    else:\n        print(f"{key:<22} no open board in the next 5 days")\n        continue\n    order = sorted(quotes, key=lambda s: quotes[s][0])\n    rank = lambda s: f"{quotes[s][0]:.2f}% #{order.index(s) + 1}" if s in quotes else "-"\n    print(f'{key:<22} {len(board):>3} books  {len(quotes):>3} full 1X2  '\n          f'{len({q[1] for q in quotes.values()}):>3} distinct  '\n          f'median {median(q[0] for q in quotes.values()):.2f}%')\n    print("    " + "   ".join(f"{s} {rank(s)}" for s in WATCH))<\/code><\/pre>\n
Argentina              274 books  240 full 1X2   91 distinct  median 7.52%\n    pinnacle 3.50% #18   betplay 3.67% #26   apuestatotal 5.86% #64\nBolivia                no open board in the next 5 days\nBrazil                 275 books  251 full 1X2   99 distinct  median 6.99%\n    pinnacle 3.12% #20   betplay 5.81% #62   apuestatotal 4.90% #42\nCONMEBOL Libertadores  258 books  244 full 1X2   90 distinct  median 7.59%\n    pinnacle 5.82% #55   betplay 2.54% #8   apuestatotal 4.89% #18\nCONMEBOL Sudamericana  260 books  238 full 1X2   82 distinct  median 7.72%\n    pinnacle 5.44% #43   betplay 3.96% #15   apuestatotal 4.99% #20\nChile                  240 books  223 full 1X2   64 distinct  median 8.96%\n    pinnacle 5.53% #8   betplay 6.84% #27   apuestatotal 6.83% #22\nColombia               253 books  235 full 1X2   86 distinct  median 8.80%\n    pinnacle 4.89% #21   betplay 3.77% #13   apuestatotal 6.55% #31\nEcuador                204 books  188 full 1X2   65 distinct  median 8.97%\n    pinnacle 5.33% #16   betplay -   apuestatotal 6.51% #20\nParaguay               no open board in the next 5 days\nPeru                   207 books  203 full 1X2   60 distinct  median 9.31%\n    pinnacle 7.82% #43   betplay -   apuestatotal 7.23% #28\nUruguay                252 books  231 full 1X2   77 distinct  median 9.84%\n    pinnacle 4.61% #16   betplay 10.07% #157   apuestatotal 5.60% #22\nVenezuela              no open board in the next 5 days<\/code><\/pre>\n
We ran this on 19 October 2026 at 13:35 UTC. Two numbers matter. First, the board is wide: 204 to 275 books per fixture. Second, the price sets collapse. Argentina’s 240 full quotes came from 91 distinct price sets, because many books run on one platform and copy its prices. Dedupe before you average, as our consensus odds guide<\/a> shows.<\/p>\n
Pinnacle ranks 8th to 55th on these boards. Exchanges, prediction markets and a few low-margin sportsbooks sit above it, and the median book charges 7% to 10%. Paraguay printed no board because its next round was four days out and the books had not opened it yet. Bolivia and Venezuela had no fixture loaded in the window. Step 3 reads Paraguay and Bolivia on played fixtures instead.<\/p>\n
The local books split three ways. apuestatotal<\/code> shares its event ID with 23 other slugs (among them lottoland<\/code>, wazamba<\/code>, estrelabet<\/code> and winpot.mx<\/code>) on all 26 boards of our census, but its 1X2 matched another book’s prices on one board only. Treat it as its own price. betplay<\/code> and rushbet.co<\/code> carry the Kambi event ID with 36 other slugs, which our Unibet API guide<\/a> maps. On five of eight Colombian boards, rushbet.co<\/code> quoted betplay<\/code>‘s exact 1X2. On the Argentine boards it charged about 13%. betano.pe<\/code> quoted the same prices as the global betano<\/code> book on every board, so it adds no independent price. Our Betano API guide<\/a> covers that family.<\/p>\n
Step 3: check the closing line on played fixtures<\/h2>\n
A live board shows you the price days before kickoff. The close shows where each book settled after the full market cycle. This step pulls the played Colombian round of 17 to 19 October from \/v4\/historical-odds<\/code> and takes the last active price before kickoff on each leg. One call per outcome keeps the payload small. Use startTime<\/code> as the cutoff, because trueStartTime<\/code> can sit a few minutes after kickoff and let in-play prices in.<\/p>\n
# Reuses get() and the imports from Step 1.\nBOOKS = "pinnacle,betplay,apuestatotal"\nCOLOMBIA, RESULT = 27070, ["101", "102", "103"]   # Full Time Result: home, draw, away\n\ndef closing_prices(fixture_id, kickoff, outcome_id):\n    """Last active price before kickoff, per book, for one outcome."""\n    hist = get("historical-odds", fixtureId=fixture_id,\n               bookmakers=BOOKS, outcomeId=outcome_id)\n    time.sleep(4.6)                    # \/historical-odds needs a longer gap\n    close = {}\n    for slug, book in (hist or {}).get("bookmakers", {}).items():\n        for market in book["markets"].values():\n            for o in market["outcomes"].values():\n                snaps = [s for s in o["players"].get("0", [])\n                         if s["active"] and s["createdAt"] < kickoff]\n                if snaps:\n                    close[slug] = snaps[-1]["price"]\n    return close\n\nplayed = get("fixtures", tournamentId=COLOMBIA,\n             **{"from": "2026-10-17", "to": "2026-10-20"}) or []\nplayed = [f for f in played if f["statusName"] == "Finished"]\n\nmargins = {s: [] for s in BOOKS.split(",")}\nfor f in sorted(played, key=lambda f: f["startTime"]):\n    kickoff = f["startTime"]           # scheduled kickoff, not trueStartTime\n    legs = [closing_prices(f["fixtureId"], kickoff, oid) for oid in RESULT]\n    row = {}\n    for slug in margins:\n        if all(slug in leg for leg in legs):\n            row[slug] = (sum(1 \/ leg[slug] for leg in legs) - 1) * 100\n            margins[slug].append(row[slug])\n    name = f'{f["participant1Name"]} v {f["participant2Name"]}'[:34]\n    print(f"{name:<34}", "  ".join(f"{s} {v:.2f}%" for s, v in row.items()))\n\nprint(f"\\n{len(played)} played Liga DIMAYOR fixtures, closing 1X2:")\nfor slug, vals in margins.items():\n    print(f"  {slug:<12} median {median(vals):.2f}%  ({len(vals)} fixtures)")<\/code><\/pre>\n
Boyaca Chico FC v Atletico Naciona pinnacle 4.90%  betplay 6.86%  apuestatotal 6.48%\nMillonarios FC v Jaguares de Cordo pinnacle 5.27%  betplay 2.94%\nIndependiente Medellin v CD Once C pinnacle 4.56%  betplay 5.89%  apuestatotal 6.55%\nAguilas Doradas Rionegro v CD Toli pinnacle 7.38%  betplay 7.30%  apuestatotal 6.46%\nCA Bucaramanga v America de Cali   pinnacle 4.47%  betplay 4.71%  apuestatotal 6.46%\nLlaneros FC v Independiente Santa  pinnacle 7.41%  betplay 10.45%  apuestatotal 6.42%\nDeportivo Cali v CD Junior FC      pinnacle 7.33%  betplay 3.48%  apuestatotal 6.53%\n\n7 played Liga DIMAYOR fixtures, closing 1X2:\n  pinnacle     median 5.27%  (7 fixtures)\n  betplay      median 5.89%  (7 fixtures)\n  apuestatotal median 6.47%  (6 fixtures)<\/code><\/pre>\n
Colombia is the split tournament. betplay<\/code> closed under Pinnacle on three of these seven fixtures, and Pinnacle took the median by 0.6 points. We ran the same check on 62 played fixtures from 10 to 19 October, across all eleven tournaments:<\/p>\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Tournament (played, 10 to 19 Oct 2026)<\/th>\nFixtures<\/th>\nMedian close, pinnacle<\/code><\/th>\nMedian close, betplay<\/code><\/th>\nMedian close, apuestatotal<\/code><\/th>\nTightest close of the three<\/th>\n<\/tr>\n<\/thead>\n
Brazil, Brasileiro Serie A<\/td>\n6<\/td>\n2.87%<\/td>\n7.19%<\/td>\n5.03%<\/td>\npinnacle 6 of 6<\/td>\n<\/tr>\n
Argentina, Primera LPF<\/td>\n8<\/td>\n3.54%<\/td>\n5.17%<\/td>\n6.01%<\/td>\npinnacle 6 of 8<\/td>\n<\/tr>\n
Chile, Primera Division<\/td>\n6<\/td>\n4.24%<\/td>\n7.21%<\/td>\n5.52%<\/td>\npinnacle 6 of 6<\/td>\n<\/tr>\n
Uruguay, Primera Division<\/td>\n6<\/td>\n4.48%<\/td>\n10.56%<\/td>\n5.49%<\/td>\npinnacle 6 of 6<\/td>\n<\/tr>\n
Ecuador, LigaPro<\/td>\n6<\/td>\n5.08%<\/td>\n7.08%<\/td>\n6.64%<\/td>\npinnacle 6 of 6<\/td>\n<\/tr>\n
Paraguay, Division de Honor<\/td>\n6<\/td>\n5.14%<\/td>\n8.84%<\/td>\n5.98%<\/td>\npinnacle 6 of 6<\/td>\n<\/tr>\n
Colombia, Liga DIMAYOR<\/td>\n8<\/td>\n5.21%<\/td>\n5.30%<\/td>\n6.46%<\/td>\nbetplay 3, pinnacle 3, apuestatotal 2<\/td>\n<\/tr>\n
Peru, Liga 1<\/td>\n6<\/td>\n6.48%<\/td>\n6.48%<\/td>\n5.49%<\/td>\napuestatotal 6 of 6<\/td>\n<\/tr>\n
Bolivia, Division Profesional<\/td>\n6<\/td>\n9.24%<\/td>\n13.10%<\/td>\n6.53%<\/td>\napuestatotal 6 of 6<\/td>\n<\/tr>\n
CONMEBOL Libertadores (semi-final first legs)<\/td>\n2<\/td>\n3.82%<\/td>\n2.97%<\/td>\n5.04%<\/td>\nbetplay 2 of 2<\/td>\n<\/tr>\n
CONMEBOL Sudamericana (semi-final first legs)<\/td>\n2<\/td>\n4.16%<\/td>\n2.76%<\/td>\n5.00%<\/td>\nbetplay 2 of 2<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n
Pinnacle closed tightest on 39 of the 62 fixtures. Its median close climbs as you move down the table: 2.87% in Brazil, over 5% in Ecuador, Paraguay and Colombia, and 9.24% in Bolivia. Apuesta Total’s median close stays between 5.0% and 6.6% in every tournament. In Peru it closed at 5.49% against Pinnacle’s 6.48%, and in Bolivia at 6.53% against 9.24%. It closed tighter than Pinnacle on 12 of those 12 fixtures. betplay<\/code> closed the four CONMEBOL semi-final first legs at 2.35% to 3.39%. Four fixtures is a small sample, so treat the cups as a lead and re-run the check after the second legs.<\/p>\n
Take the fair price from the deduplicated board, de-vigged, and use the table to pick the reference close per tournament. Pinnacle is the tightest of the three in Brazil, Argentina, Chile, Uruguay, Ecuador and Paraguay. In Peru and Bolivia, compare against apuestatotal<\/code>. In Colombia, read pinnacle<\/code> and betplay<\/code> side by side. Our backtesting guide<\/a> turns closes like these into a full strategy test, and our African football odds API guide<\/a> runs the same local-book check on a different region.<\/p>\n
Snapshots record polling, so collapse identical consecutive prices before you count line moves. To read these boards live without a polling loop, use the WebSocket feed<\/a>. For a one-page view of the Brazilian top flight, see the Brasileir\u00e3o league page<\/a>.<\/p>\n
South America sports betting API FAQ<\/h2>\n
Is there a sports betting API for South American soccer?<\/h3>\n
Yes. OddsPapi carries 68 South American soccer tournaments with fixtures loaded, among them Argentina’s Primera LPF, Colombia’s Liga DIMAYOR, Peru’s Liga 1, the Brasileiro Serie A and both CONMEBOL club cups. Call \/v4\/odds with a fixtureId and your apiKey.<\/p>\n
How many bookmakers price South American soccer?<\/h3>\n
On 26 open top-flight boards read on 19 October 2026, the median fixture carried 247 bookmakers, and the deepest Argentine board carried 276. They include Pinnacle, exchanges, US books, crypto and offshore sportsbooks and local books.<\/p>\n
Which South American bookmakers can I read through the API?<\/h3>\n
The local slugs include apuestatotal (Peru), betplay and rushbet.co (Colombia), betano.pe, and Brazilian licensees such as betano.bet.br, estrelabet.bet.br and kto.bet.br. Check the live \/v4\/bookmakers catalogue for the current list.<\/p>\n
Which bookmaker closes South American soccer tightest?<\/h3>\n
Across 62 played fixtures from 10 to 19 October 2026, Pinnacle closed the 1X2 tightest of three books on 39. Apuesta Total closed under Pinnacle on 12 of 12 Peru and Bolivia fixtures, and betplay closed the four CONMEBOL semi-final first legs at 2.35% to 3.39%.<\/p>\n
Can I get historical odds for Copa Libertadores fixtures?<\/h3>\n
Yes. \/v4\/historical-odds returns snapshots on played fixtures, on the free tier. Pass the fixtureId, up to three bookmaker slugs and one outcomeId to keep the payload small, then take the last active snapshot before startTime as the close.<\/p>\n
Read 247 books per fixture from one key<\/h2>\n
Every call in this guide runs on the free key: 350+ bookmakers in the catalogue, free historical odds for the closing-line check, and a WebSocket feed when polling gets too slow. Get a free API key<\/a> and run Step 2 on the next round in your tournament.<\/p>\n