Skip to content

General overview

Key Concepts

A Bet is a betting transaction placed by a bettor containing one or more selections with an associated stake amount.
A Selection is a specific betting choice made by a bettor, consisting of a sport event (match), market, outcome, and the associated odds value. Each selection represents a single prediction on which a bettor wants to place money. A selection can include both DATA.BET and external (non-DATA.BET) events, markets, or odds. Selections containing external elements are called foreign selections.
A Market is a betting category that represents a specific aspect of a sport event with multiple possible outcomes. Common examples include "Match Winner", "Total Goals", "Both Teams to Score", or "Player to Score". Each market offers different betting opportunities within the same event.
An Odd represents the probability and potential payout for a specific outcome within a market. The odds value indicates both the likelihood of the outcome occurring and the multiplier applied to the stake if the bet wins. Odds include a margin that ensures the bookmaker's profitability.
Cash Out is a feature that allows bettors to settle their bets before the event concludes, receiving a calculated payout based on current market conditions and the likelihood of winning. This provides flexibility to secure profits or minimize losses during live betting.
Managed Trading Services (MTS) is a comprehensive platform providing bet validation, integrity checks, and risk management capabilities. MTS ensures financial security and integration correctness while offering flexible integration modes to meet different business needs. See MTS Modes for available integration options.
A Restriction is a validation rule or limit applied to bets to ensure integrity, enforce risk management, or control betting behavior. Restrictions validate bet data, enforce betting limits, or prevent certain betting actions based on predefined rules. See Restrictions for detailed restriction types.

Types of bets

There are three types of bets. Each bet contains a set of outcomes with fixed odds (selections a player makes):

  • Single is a bet on one sport event.
  • Bet Builder is a subtype of single bets that allows users to create customized bets by combining multiple markets within a single sports event. See Bet Builder documentation for more details.
  • Express (also referred as combo, accumulator or multiples) - Express (also referred as combo, accumulator or multiples) is a bet on simultaneous forecast of the outcome of two or more independent events.
  • System is a bet that consists of three or more combo bets. It includes all possible combinations of a fixed size formed from the selected outcomes. The same stake amount is applied to each combo (each system option).
Settlement logic

The logic of calculating winnings depends on the type of bet.

Bet type Settlement logic
Single The amount of winnings for single bets is calculated by multiplying the bet amount by the odds for the given outcome of the event.
Express A combo bet wins only if all selected outcomes are correct; a single incorrect prediction results in a loss. If a selection is void, its odds are converted to 1.0. Winnings are calculated by multiplying the odds of all outcomes by the bet amount and rounding to three decimal places. Displayed combo odds are rounded to two decimal places for convenience and are not used in the winnings calculation.
System A system bet type implies that the same bet amount is placed on each combo (each system option) and the number of outcomes is the same in each combo. The system winnings are the sum of the winnings of the combos that make up the system.

MTS Modes

  • Integrity Mode – The MTS platform provides bet validation and integrity checks without enforcing risk management rules. This mode ensures financial security and integration correctness while allowing clients to use their own risk management systems. Recommended as the starting point for most integrations. Integrity Mode documentation.

  • Risk Management Mode – Full MTS platform control including integrity validation, risk management, and all restrictions. This mode adds comprehensive risk controls on top of Integrity Mode for maximum protection. Risk Management Mode documentation.

  • Advisory Mode – No validation or risk management is applied. The bookmaker assumes full responsibility for all validation and risk management. Suitable for setups where synchronous communication with MTS is impossible, allowing bets to be sent post-factum, but carries significant operational risks due to lack of integrity validation. Advisory Mode documentation.

Bet Integration Requirement

One of the above bet integrations (Integrity Mode, Advisory Mode, or Risk Management Mode) is required to go-live with the Odds Feed integration

Feature Integrity Mode Advisory Mode Risk Management Mode
Integrity Validation ✅ Full ❌ None ✅ Full
Risk Management ❌ None ❌ None ✅ Full
Bet Delays ✅ Optional ❌ None ✅ Full
Max Bet Limits ❌ None ❌ None ✅ Full
User Risk Groups ❌ None ❌ None ✅ Full
Integration Complexity ✅ Very Low ❌ High ✅ Low
Client Risk ✅ Low ❌ High ✅ Very Low

Can we launch without any of those MTS integrations?

Launching without bet integration is not a supported setup as it poses significant risks to your operation. The following considerations should be taken into account:

Integration Testing Limitations Without bet integration, comprehensive integration testing cannot be performed. This results in untested edge cases being deployed to production, creating a high risk of critical issues that could impact your business operations.

Operational Monitoring Challenges The initial days after launch are critical for monitoring operations and responding quickly to any issues. Without bet integration, our support team cannot provide effective assistance as they lack visibility into bet-related operations. MTS includes a dedicated team of approximately 15 risk management experts who provide ongoing support and monitoring capabilities.

Financial Reporting and Invoicing Bet integration enables accurate calculation of bet reports and proper invoicing processes. Without this integration, the system would rely entirely on external reports, which may require additional approval processes and could impact financial accuracy.

Dynamic Line Adjustment Our system leverages bet integration to adjust the line dynamically based on bookmaker load. This real-time adjustment capability is essential for optimal risk management and cannot function without proper bet integration.

Summary It is strongly recommended to ensure bet integration is completed before production launch

Restrictions

Managed trading services have several restrictions that can be applied to bets. These restrictions are categorized by their purpose and which MTS modes enforce them.

Each restriction is characterized by a type and context. The context interface is closely coupled with the restriction type.

Integrity Restrictions

These restrictions ensure bet validity and data integrity. They are enforced in Integrity Mode and Risk Management Mode:

  • selection_value - Validates that the odd value is relevant and, if a bet delay is applied, that any changes during the delay aligns with the selected Odd Acceptance Strategy
  • sport_event_status - Ensures sport events are in bettable states. See Fixture Status for details on valid sport event statuses
  • sport_event_existence - Validates sport event exists in the system
  • sport_event_bet_stop - Prevents betting when bet stop is activated. See Bet Stop for details on how to handle the bet stop signal
  • market_status - Ensures markets are active and available. See Market Status for details on valid sport event statuses
  • market_existence - Validates markets exist in the system
  • market_defective - Prevents betting on defective markets
  • odd_status - Ensures odds are in valid states. See Odd Status for details on valid sport event statuses
  • odd_existence - Validates odds exist in the system
  • bet_type - Validates bet type matches selection count or that specific bet type is restricted for a specific sport event
  • bet_builder_value - Validates that the total odds for a Bet Builder combination are current and valid
  • bet_builder_unavailable - Indicates that the Bet Builder feature is unavailable (general or event-specific)
Risk Management Restrictions

These restrictions enforce betting limits and risk controls. They are only enforced in Risk Management Mode:

  • max_bet - Enforces maximum bet limits per user/event
  • bet_interval - Enforces delays between similar bets from a single user

Cash Out Restrictions

Integrity Restrictions:
  • sport_event_status - Ensures sport events are in bettable states. See Fixture Status for details on valid sport event statuses
  • sport_event_existence - Validates sport event exists in the system
  • market_existence - Validates markets exist in the system
  • odd_existence - Validates odds exist in the system
  • market_status - Ensures markets are active and available. See Market Status for details on valid sport event statuses
  • sport_event_bet_stop - Prevents betting when bet stop is activated. See Bet Stop for details on how to handle the bet stop signal
  • market_defective - Prevents betting on defective markets
  • odd_status - Ensures odds are in valid states. See Odd Status for details on valid sport event statuses
  • selection_value - Validates that the odd value is relevant and, if a bet delay is applied, that any changes during the delay aligns with the selected Odd Acceptance Strategy
  • bet_status - Validates bet status for Cash Out eligibility
  • bet_selection_existence - Ensures selections exist for Cash Out
  • sport_event_type - Validates sport event type for Cash Out
  • cash_out_bet_type - Validates bet type for Cash Out eligibility
  • bet_cash_out_selections_mismatch - Ensures Cash Out selections match bet
  • cash_out_unavailable - Checks Cash Out availability
  • cash_out_order_status - Validates Cash Out order status
  • cash_out_amount_limit - Validates the Cash Out portion of stake is not higher than the initial stake
Risk Management Restrictions

These restrictions enforce betting limits and risk controls. They are only enforced in Risk Management Mode:

  • cash_out_refund_amount - Validates refund amounts against risk rules

For more details, please refer to BetRestriction and CashOutOrderRestriction schemas.