OddStream.io
CoberturaPreçosDocs
ENFRESDEITPT
Iniciar sessão
Obter chave API

Produto

  • Cobertura
  • Preços
  • Docs
  • Mercados
  • Blog

Bookmakers

  • Bwin API
  • Winamax API
  • Betclic API
  • Unibet API
  • Daznbet API
  • Vbet API
  • PMU API
  • Betsson API

Desportos

  • Futebol API
  • Ténis API
  • Basquetebol API
  • Râguebi API
  • Andebol API
  • Hóquei no gelo API
  • Todos os desportos →

Competições

  • Ligue 1 API
  • Premier League API
  • Champions League API
  • NBA API
  • Top 14 API
  • NFL API
  • Todas as competições →

Comparações

  • vs The Odds API
  • vs OpticOdds
  • vs BetsAPI
  • vs Sportradar
  • vs Sportmonks
OddStream

OddStream

Desenvolvido pela StatsnBet.
O feed em tempo real para apostadores profissionais.

© 2026 OddStream.io. Todos os direitos reservados.

Todos os artigos

Publicado a 15 de junho de 2026 · OddStream Team

What Is Bet Settlement? How Automated Settlement Works

What bet settlement means, why manual grading breaks at scale, how an API delivers official results, and how voids and postponements are handled.

Settlement: the step everyone underestimates

Settlement is the process of determining the final outcome of a bet: did the selection win, lose, push, or get voided, and what is the resulting payout. It sounds trivial, and for a single moneyline bet it is. But any serious betting operation, whether a tracking tool, a tipster platform, or an automated strategy, lives or dies on settlement accuracy.

The reason is compounding. Your profit and loss, your ROI, your closing line value analysis, and your staking decisions all flow from graded results. One systematically misgraded market, say Asian handicaps settled as two-way instead of with pushes, silently corrupts every downstream number.

Why manual settlement does not scale

Grading bets by hand means checking final scores, applying market rules, and updating records. At 10 bets a week this is a minor chore. At 500 bets a week across football, tennis, and basketball, it is a part-time job with a meaningful error rate, because market rules differ by sport and by bookmaker.

Consider the rule surface: over/under 2.5 goals is simple, but a draw no bet needs void logic, a first-half handicap needs period-specific scores, and a tennis match retired at one set all has different void rules at different bookmakers. Humans get these wrong under volume; worse, they get them wrong inconsistently, which makes errors hard to detect.

There is also timing. Results matter most right after the event, when you want to update bankroll and unlock capital for the next bets. Manual grading introduces hours of lag, and during that window your effective bankroll and your recorded bankroll disagree.

What official settlement means

There is a difference between a live score feed and an official result. Scores can be corrected after the final whistle, matches can be awarded or annulled, and statistical markets like cards or corners depend on the data provider a bookmaker designates as official. A bet is only truly settled when the settling authority, the bookmaker, grades it.

This is why settlement-grade data feeds report the outcome per market as the bookmakers settle it, not just a raw score. OddStream, for example, exposes official settlement across its covered markets on the eight French ANJ bookmakers, so a bet you track through the API is graded the same way the bookmaker grades the real ticket. Your records and the bookmaker's records cannot drift apart.

How an automated settlement pipeline works

The pipeline has three stages. First, event completion detection: the feed marks the fixture finished and emits final period-by-period data. Second, market resolution: each market on that event is resolved to won, lost, half-won, half-lost, push, or void according to its rules. Third, bet grading: your stored bets are matched to resolved markets and their pnl is computed, stake × (odds − 1) for a win, −stake for a loss, 0 for a push.

Consuming this via API reduces your code to a join. You store the market ID and selection when you log a bet; when the settlement message arrives, either via WebSocket push or a REST poll of a settlements endpoint, you look up your open bets on that market and write the result. No score parsing, no rules engine, no 2 a.m. corrections.

Edge cases: voids, postponements, and corrections

Voids are the most common trap. A postponed match, an abandoned match, or a non-runner typically voids the bet, returning the stake with pnl of exactly zero. If your system records voids as losses, or ignores them, your ROI is understated and your bet count is wrong. A proper feed emits an explicit void status rather than just omitting the result.

Postponements need state handling: an event may move from scheduled to postponed and then either to a new date or to cancelled. Most bookmakers void football bets if the match is not played within a defined window, commonly 24 to 72 hours, and rules vary by book. Automated settlement tracks these transitions so your bets are not stuck open forever.

Finally, corrections happen. A late own-goal reattribution or a data provider fix can flip a statistical market after initial settlement. Robust pipelines treat settlement as an upsert, not a write-once event, and re-emit a corrected status when the official result changes. Your storage layer should be built to accept a re-grade.

Why this matters even if you never automate bets

Even a purely analytical use case, backtesting a strategy or auditing a tipster, depends on settlement fidelity. A backtest over 50,000 historical bets is only as good as the grading of those bets; a 1% grading error rate can move a marginal strategy from +2% ROI to break-even or vice versa.

The practical takeaway: treat settlement as infrastructure, not bookkeeping. Get official, per-market results from a feed that handles voids and corrections, verify pnl math against a sample of real tickets once, and then let the pipeline run. It is the least glamorous part of the stack and the one most likely to invalidate everything else if done casually.

OddStream API