Skip to main content
API

Arbitrage bets: fees, stake limits and new filters

  • Margins after exchange fees. On exchanges and prediction markets, profitMargin, impliedProbability and optimalStakes now use the price after commission or taker fees. Those legs carry it as netOdds.
  • Stakes within bookmaker limits. Legs carry maxStake when the bookmaker reports a limit, and the split is scaled down so no leg goes over it. totalStake is 1000 or lower.
  • New fields. legs[].oddsUpdatedAt (last time the price was written) and firstSeenAt (when the combination first appeared).
  • One row per line by default. Each event, market and line returns its best combination among your bookmakers. Add allCombinations=true for every combination.
  • New filters on /v3/arbitrage-bets: sport, league, markets and minProfit. See the Arbitrage Bets guide.
WebSocket

WebSocket updates now arrive in sequence order

  • seq never decreases on a connection. Updates, including deleted messages, are delivered in seq order, so the highest seq you have received is a safe cursor for lastSeq when you reconnect. The same update sent for several bookmakers shares one seq, so identify a frame by id, bookie and seq together.
  • New replayComplete=true option. Add it to the connection URL to receive a replay_complete message once a reconnect has caught up on everything you missed. See Reconnection with Replay.
Markets

Regulation-time markets in ice hockey and basketball

Four new markets settle at the end of regulation time, without overtime or a shootout: Totals Regulation, Spread Regulation, Team Total Home Regulation and Team Total Away Regulation, and /v3/settlements/grade grades them.In ice hockey, basketball, baseball and American football, ML, Spread, Totals and the team totals now always include overtime, extra innings and the shootout. A bookmaker’s regulation-time line is only returned under the Regulation names, and the regulation result with a draw is 3-Way Result.
API

WebSocket compression required, and two /v3/odds/updated dates

  • WebSocket compression is now required. Since 15 October 2026 09:00 UTC, connections that don’t negotiate permessage-deflate are refused with 426. See Compression.
  • markets is required on /v3/odds/updated from Monday 19 October 2026, 09:00 UTC. A call without it, or where none of the names exist, returns 400.
  • /v3/odds/updated returns only changed markets from Thursday 22 October 2026, 09:00 UTC. Merge each response into your stored markets by market name instead of replacing an event’s market list. A missing market means unchanged, not removed. See Keeping Odds Fresh.
Coverage

50 bookmakers added

50 more sportsbooks are now live, including 19 in Australia.
  • 🇦🇺 Neds AU, Ladbrokes AU, Picklebet AU, Betr AU, Dabble AU, Swiftbet AU, PlayUp AU, NextBet AU, Betdeluxe AU, Bet Right AU, Surge AU, Noisy AU, BetNation AU, PulseBet AU, BigBet AU, YesBet AU, BetExpress AU, MightyBet AU, BetJet AU
  • 🇨🇦 Proline+, PlayNow
  • 🇺🇸 BetUS
  • 🇩🇪 Bpremium, OddSet, Wettarena, Bet3000, TipTorro, 888Sport DE, Betway DE
  • 🇩🇰 Expekt DK, LeoVegas DK, Bwin DK, MrGreen DK, 888Sport DK
  • 🇬🇧 LeoVegas UK, 7Bet UK
  • 🇮🇪 Unibet IE
  • 🇪🇸 Betway ES, Winamax ES, 888Sport ES
  • 🇵🇹 Bwin PT
  • 🇮🇹 NetBet IT, Betsson IT
  • 🇵🇱 Superbet PL
  • 🇷🇸 Superbet RS
  • 🇧🇪 Bingoal BE
  • 🇷🇴 Betano RO, Fortuna RO
  • 🇬🇷 Fonbet GR
  • 🌐 Bwin
All are listed in GET /v3/bookmakers and available on REST and WebSocket, pre-match. PlayNow and Fonbet GR are also available in-play.
Esports

Esports: team logos, game, parent league, region and match format

Esports events now carry an esports object with the game, the parent league (VCT, LCK, LEC), the region and the match format:
The parent league slug stays the same across a league’s splits and stages, so you can group events on it. It is returned by /v3/events, /v3/events/live, /v3/events/search and /v3/events/{id}. Historical events do not carry it.GET /v3/participants/{id}/logo now serves esports team logos. Esports rows in /v3/participants add game and, when known, shortCode, so teams that share a name across games can be told apart. See the Live Events guide.
New endpoint

Settle bets with the API

Two new endpoints tell you what happened in an event and whether a bet won.
/v3/settlements returns the status, final score and a final flag for up to 50 events. Cancelled and not yet resulted events get an explicit answer too, which /v3/historical/events never gave you./v3/settlements/grade takes up to 50 bets and returns won, lost, void, half_won or half_lost for each one. Describe a bet with the fields you already have from /v3/odds:
  • 64 markets in 20 sports: moneyline, spreads and Asian handicaps with quarter lines, totals, both teams to score, double chance, half-time markets, tennis games and sets, esports maps, football corners and bookings, and player props in basketball, baseball, ice hockey and American football.
  • Football settles on 90 minutes. Extra time and penalties never count, even though the match score includes them. Each grade shows the score it was based on.
  • No guessing. When the stored result cannot prove the answer, the bet comes back ungradeable with a reason.
Available on all paid plans. See the Bet Settlement guide for the rules and the full market list.
CoverageWebSocket

SingBet price groups: SingBet A, B, C and D

Crown (SingBet) shows handicap, totals and odd/even prices at four price groups, depending on the site and the account. SingBet and Crown keep the group they have always had. Four new bookmakers carry each group on its own: SingBet A, SingBet B, SingBet C and SingBet D, from the lowest prices to the highest.To find your group, add the two Hong Kong prices of one handicap line on your Crown page and compare the sum with the same line in each group. The sum stays the same when the line moves. Moneyline, correct score and the other markets are identical in all groups.The new bookmakers are available on REST and WebSocket on paid plans, for football and basketball, pre-match and live.
OddsWebSocket

Up to 40 markets per request

The markets parameter now takes up to 40 names, up from 20, on /v3/odds, /v3/odds/multi, /v3/odds/updated and the WebSocket feed. A longer list still returns 400 (Maximum 40 markets allowed, or Too many markets. Maximum 40 allowed. on the WebSocket).
OddsPrediction markets

Kalshi depth is now in US dollars

Kalshi’s depth fields on /v3/odds, /v3/odds/multi and the WebSocket now show the stake in US dollars you can place at the best price, as documented and as Polymarket, NoVig and ProphetX already do. They previously showed the number of contracts at the top of the book.The new value is contracts × the price per contract, so it is lower than before. For example, 31,694 contracts at 35 cents now reads 11,093. If you divided Kalshi depth by the price yourself, remove that step.
New endpoint

Odds summary: GET /v3/odds/summary

One call gives you the best, average, median, worst and margin-free fair price for every market line of an event across bookmakers, with the bookmakers offering the best price. It is built for odds comparison pages: show the average or best odds on a fixtures list without pulling every bookmaker.
  • Up to 10 events per call with /v3/odds/summary/multi, counted as one request.
  • One vote per bookmaker and only fresh prices. A bookmaker whose row has any outlier price is kept out of best, worst and average, and a line needs at least 3 bookmakers without one.
  • Exchanges reported separately with includeExchanges=true.
Available on Growth plans and above. Free, Solo and Starter plans get a sample response, marked with "demo": true, to build against. See the Odds Summary guide.
Odds

Easier odds movements requests

GET /v3/odds/movements now accepts requests the way /v3/odds returns them:
  • marketLine is optional. Markets without a line (Draw No Bet, Both Teams To Score, ML HT) work without it. On Spread and Totals markets, leaving it out returns the main line, the most balanced line, and each entry’s hdp shows which line that was.
  • Names are case-insensitive for market and bookmaker, and Bet365 (no latency) is accepted.
  • Lines match by value, so 2.50 finds 2.5.
  • A new latest field holds the most recent price.
  • 404s say what is missing: the bookmaker has no odds for the event, has no history for it, or lacks that market or line. They list the markets or lines that do have history.
Existing requests return the same data as before.
Coverage

Odds movements for 29 more bookmakers

GET /v3/odds/movements now returns prematch price history for 1xbet, 22Bet, 888Sport, BC.Game, Betano, Betclic FR, Betfair Exchange, Betfair Sportsbook, BetMGM, Betsson, Betway, Bovada, CloudBet, Coolbet, Goldbet IT, Kalshi, Kambi, Ladbrokes, Paddy Power, Pamestoixima, Sharp Exchange, Sisal IT, Stake, Stoiximan, Tipico DE, Unibet, Vbet, William Hill and Winamax FR. 10BET and Polymarket are now listed too.History for these bookmakers starts from today, so events kicking off soon will have short series at first. Betfair Exchange and Sharp Exchange record the back price.
New endpoint

Native ID mappings: GET /v3/mappings

Link our events and selections to a bookmaker’s own ids. For every selection we price, you get the bookmaker’s event, market and outcome id, in our event’s orientation.
Polymarket and Kalshi are supported from today.
  • Look up by eventId, marketId, outcomeId, or marketId with outcomeId (needed for Kalshi, where yes/no alone matches every market). Batch with eventIds or marketIds, up to 10 per call.
  • Keep a local copy with bulk sync: send only bookmaker, optionally sport, league and market, and follow nextCursor page by page.
  • Join to prices on eventId, market, hdp and side, the same fields /v3/odds uses. Each row also carries the event’s teams, date, sport and league.
  • Mappings outlive prices. A mapping stays available when its price briefly disappears, and a withdrawn outcome stays listed with active: false. lastCheckedAt shows when we last confirmed it.
Available on paid plans, for bookmakers in your selection. See the Native ID Mappings guide.
Coverage

Five Danish bookmakers added

Five more Danish sportsbooks are now live: 🇩🇰 Swiper DK, Betoro DK, Vbet DK, GetLucky DK and Casinostuen DK.
  • Listed in GET /v3/bookmakers and available on REST and WebSocket
  • Pre-match and in-play, with ML, totals and spreads
Coverage

ProphetX exchange added

ProphetX, the US sports exchange, is now available as ProphetX on paid plans, alongside NoVig in the betting exchanges group.
  • NFL, NCAAF, MLB, WNBA, MLS, UFC, ATP and WTA, pre-match and in-play
  • Moneyline, spreads, totals, first half and first five innings lines, plus player prop ladders
  • Moneyline, spread and total lines carry max stake, lay prices and depth from the ProphetX orderbook
Markets

Handball ML is always the three-way result

Handball ML is now always the full-time three-way result (home, draw, away), for every bookmaker. Two-way handball winner prices are listed under Draw No Bet.
  • Bookmakers that only listed the three-way result under 3-Way Result now also return it as ML. 3-Way Result stays available
  • Historical handball odds follow the same rule
Billing

Annual plans: 12 months for the price of 10

Every plan (Solo, Starter, Growth, Pro and their WebSocket variants) can now be billed yearly at 10x the monthly price.
  • Choose Annual at checkout on odds-api.io/pricing
  • Existing monthly customers can switch from the dashboard Billing page. The switch is prorated and charged to the stored card straight away
  • Annual plans are card only for now. Extra request packages stay monthly and cannot be combined with a yearly plan
  • Promo codes apply to monthly plans only, since annual already includes 2 months free
Coverage

The bookmaker catalogue passed 365 books

GET /v3/bookmakers now returns 365 bookmakers, 360 of them active. 80 books became available in the last seven days.New this week
  • 🇳🇱 711 NL, Betcity NL, Betnation NL, Bingoal NL, Hommerson NL, Jacks NL, Unibet NL
  • 🇸🇪 BetMGM SE, Casumo SE, Hajper, LeoVegas SE, Snabbare
  • 🇬🇧 32Red, BetMGM UK, Casumo, Sky Bet
  • 🇧🇬 Bet.bg, Inbet
  • 🇨🇴 Codere CO, RushBet CO
  • 🇪🇪 Paf EE, Vivatbet
  • 🇪🇸 Casumo ES, Codere ES
  • 🇨🇦 NorthStar Bets
  • 🇩🇪 Winamax DE
  • 🇮🇪 BoyleSports
  • 🇮🇹 Stanleybet IT
  • 🇱🇻 Paf LV
  • 🌐 Bet2Fun, Betandyou, BetFriday, Betfrom, Betfury, Betlabel, BetMartini, BetRebels, BetsAmigo, Betspino, Betstro, BetWhale, BillyBets, Bitz, Bons, Boomerang Bet, Campobet, Casino-X, Casinova, Casinozer, Casombie, Cazimbo, Chips.gg, Cosmobet, Excitewin, FanSport, Fastbet, Helabet, Highbet, JoyCasino, Lilibet, Linebet, MalinaCasino, Marathonbet, Mobilebet, MrPacho, NovaJackpot, Nucleonbet, Paripesa, PlayZilla, Rakebit, Ramenbet, Riobet, Spinanga, Spinsy, Superboss, WallaceBet, Winnerz, WinWinBet, XpariBet, Yonibet
OddsWebSocket

ON Sharp: one consensus line from the sharpest books

ON Sharp is a new bookmaker computed by odds-api.io. It blends the sharpest, highest-limit books in the market into one line: each book is de-vigged, the fair probabilities are blended, and the result is re-priced at a fixed margin of 2% on two-way markets and 2.5% on three-way markets. Strip the margin with one division and you have the sharp market’s fair probability.It covers prematch ML, Spread and Totals (full match and first half) across football, basketball, tennis, American football, baseball, ice hockey and esports, plus football corners, tennis game lines and baseball first five innings. Lines update in real time on the WebSocket and every change is kept in /v3/odds/movements, so you can measure closing line value against it.Available on all paid plans. Add ON Sharp to your bookmaker selection and request it like any other book: /v3/odds?eventId=...&bookmakers=ON Sharp. Details in the ON Sharp guide.
OddsWebSocket

Delta fetching for /v3/odds/updated, and gzip on every response

GET /v3/odds/updated now accepts a markets parameter (comma-separated, max 20) to shrink the payload to markets you care about, and a limit parameter (1-10000, default 10000) to cap how many rows come back. Every response also carries two new headers: X-Server-Time (the server’s clock at response time) and X-Next-Since (pass this straight back as your next since value). Recipe: start with since = now - 20, then on each poll set since to the previous response’s X-Next-Since.Every REST response is now sent gzip-compressed, whether or not your request sends an Accept-Encoding header. Most HTTP clients decompress this automatically; see the Best Practices guide if yours doesn’t.WebSocket clients must negotiate permessage-deflate compression. Uncompressed connections will stop being accepted soon. Node ws, browsers and Python websockets all negotiate this by default; if you’re on Python websocket-client or PHP textalk/websocket, switch to websockets / amphp/websocket-client. See the WebSocket guide for details.GET /v3/odds and GET /v3/odds/multi now accept the same optional markets parameter as /v3/odds/updated (comma-separated, case-insensitive, max 20). Leave it out to get every market, as before.
Odds

Retired market names are gone

The deprecated names from the 15 Aug rename stopped being served on 5 September 2026, as announced. Every market now returns under its standard name only. If you still filter on an old name (Half Time Result, Alternative Run Line, 1st Map Moneyline, Pitcher Strikeouts O/U, …) you will get no rows back: switch to the replacement in the mapping table below, or check GET /v3/markets?sport=<sport> for the current catalogue.
New endpoint

Market catalogue: GET /v3/markets

See every market we serve, per sport, straight from live coverage:
Each market has a shape telling you how to parse its odds (moneyline, line, outcomes, yesno, labelled), a period (match, first-half, set, …) and prematch/live flags. Omit sport to get everything keyed by sport slug.
OddsCoverage

Market normalization and much wider Bet365 coverage

We’ve normalized market names and shapes across all our scrapers, mostly affecting Bet365. Markets that used bookmaker-specific names now return under the same standard names as every other book, so cross-bookmaker filtering and comparison just works.Bet365 got a lot more. All handicap and goal lines now come back instead of only the main one (Spread went from 1 to ~5 lines per event, Totals from 1 to ~8), around 30 new pre-match football markets, wider in-play football, and in-play tennis grew from 3 markets to 33: per-set totals, handicaps and scores, plus per-game winners.Player props are one market on every bookmaker. Bet365 used to send ~58 separate per-stat markets (Points O/U, Pitcher Strikeouts O/U, …), and with the WebSocket’s 20-market filter limit you could not cover them. Baseball, basketball, American football and ice hockey props now come back in a single Player Props market with Player (Stat) labels on every book, so one filter covers the lot and props compare across bookmakers. Stat names and player names were unified too: batter hits read Hits (not Pitching Hits).Nothing breaks today. Every renamed market keeps returning under its old name for three weeks. On 5 September 2026 the deprecated names below stop being served, so switch to the standard name before then. The full list:
Billing

Pay with crypto

You can now pay for any plan with cryptocurrency. Choose Crypto at checkout and pay with BTC, ETH, USDC, TRX, SOL, LTC and more (10+ coins). Payments are handled by CoinGate, licensed as a crypto-asset service provider by the Bank of Lithuania.Upgrades, extra requests and the WebSocket add-on work on crypto too, with the prorated amount shown before you confirm.One difference from cards: crypto cannot be charged automatically, so each renewal arrives as an invoice with a payment link, by email and in your dashboard. Your API access continues while the invoice is open. Full details in the crypto payments guide.
HistoricalNew endpoint

Find finished matches by team name

/v3/historical/events needs an exact sport and league, so a team name alone was never enough to find a finished match. The new /v3/historical/events/search endpoint fixes that:
query matches home or away team (case-insensitive, minimum 3 characters); sport and a from/to window of up to 31 days are optional. Up to 100 results, newest first, in the same shape as /v3/historical/events, so event IDs plug straight into /v3/historical/odds. Available on every plan. Details in the historical data guide.
Coverage

New lower-tier leagues for football and basketball

We’ve added a batch of lower-tier and niche competitions, with live scores and the live clock included.Football: Bhutan Premier League, Kuwait First Division, Guatemala Primera División de Ascenso, Vietnam Women’s National League, Mexico U19 League, Poland IV Liga, and Brazilian lower tiers.Basketball: Rwanda Basketball League is live now; Uganda NBL, Singapore NBL, Bahrain, Iraq, Malaysia MBL, Morocco, Albania, Bolivia, Puerto Rico and Brazil LBF follow as their seasons schedule fixtures.Missing a league you need? Tell us in support chat or at hello@odds-api.io and we’ll usually have it live within a day or two.
HistoricalNew endpoint

Historical closing lines in a single request

Pulling closing lines used to mean listing events for a league, then making one request per match. For a full season across several leagues that ran to roughly 1,900 requests.The new /v3/historical/closing-lines endpoint does it in one call. Give it a sport, up to 10 leagues, a date range, the markets you want and your bookmakers, and it returns every settled event in that window with closing odds attached:
Responses are capped at 100 events, with limit and skip for paging. The date span goes up to 366 days, so a whole season fits in one range.Closing odds go back to December 2025.This endpoint is available on paid plans. /v3/historical/events and /v3/historical/odds are unchanged and still available on every plan, including free.Also new: /v3/historical/odds now accepts an optional markets parameter, so you can ask for just the markets you need instead of filtering hundreds of them client-side.See the historical odds guide for the full reference.
WebSockets

Live match clocks in WebSocket updates

Live score and status messages now include an optional clock snapshot when clock data is available. Use it to re-anchor a client-side match timer after every score or status change without repeatedly polling the API.Seed the initial value from GET /events/live when you connect, then use subsequent WebSocket snapshots to keep it aligned. The clock is omitted for non-live events and sports without clock data. See the WebSocket guide for subscription details.
Free tier

More sharp books moved to paid plans

Two additional sharp bookmakers now require a paid plan: Crown and 188bet. As before, the free plan keeps every recreational book. See the full list of paid-only bookmakers below.
Free tier

Free tier changes

Starting 26 July 2026, we’re refocusing the free plan as a way to test the API before choosing a paid plan, not a place to run production workloads. Two changes:
  • Sharp and exchange bookmakers move to paid plans. The free plan keeps every recreational book (Bet365, DraftKings, FanDuel, Unibet, and many more). Betting exchanges, sharp bookmakers, and prediction markets require a paid plan.
  • A daily request limit. The free plan will be capped at 500 requests/day (the 100/hour burst limit is unchanged). That’s plenty to evaluate the API, and paid plans get 5,000 requests an hour.
Need full access? See plans from £49/mo.

Bookmakers that require a paid plan

Betting exchanges: Betfair Exchange, Orbit Exchange, Piwi247 Exchange, Sharp Exchange, Fair999 Exchange, NoVig, SkyExchangeSharp & Asian bookmakers: Sbobet, Circa, SingBet, Crown, 188bet, BetOnline.ag, LowVig AG, SportBetting AG, Tiger Gaming, 10BET, 12bet, DafaBetPrediction markets: Polymarket, Kalshi