Skip to content

Bet Boost

General information

A Bet Boost is a type of bonus that increases the total odds value. While the Bet Boost is applied to the entire bet, the margin calculation_strategy conditions define which individual odds are eligible to contribute their margin to the Bet Boost multiplier.

Calculation Logic

The winnings for a boosted bet are calculated using the formula:

Winnings = Stake × Odds × Bet Boost multiplier

Example

  • Bet Stake: 10$
  • Bet Boost multiplier: 1.1
  • Base odds value: 6.0
  • Total odds value: 6.0 x 1.1 = 6.6
  • Calculation: 10$ × 6.6 = 66$

The lifecycle of a Bet Boost

  1. The integration client creates a Bet Boost through the API.
  2. The player can view available Bet Boosts in the frontend and place a bet with a selected Bet Boost applied.
    • The integration receives the bet_boost_id field in the /bet/place callback.
    • If the bet is accepted: bet_boost_id is included in a subsequent /bet/accept callback.
    • If the bet is declined or placed with an error: the Bet Boost becomes available for use again, and the player's balance remains unchanged.
  3. When the bet is settled, the /bet/settle callback payload also includes the relevant bet_boost_id, allowing the integration to identify which boost was applied.
    • When the bet is won, the settle_amount field reflects the final payout amount to be credited to the player, including the Bet Boost effect.
    • If the bet with a Bet Boost is voided (refunded/cancelled): the player will receive a refund without the Bet Boost multiplier and the Bet Boost is considered used.

Integration details

The Betting platform provides APIs that allow integrations to create and manage Bet Boosts for players. Once granted, players can apply these boosts only to wagers that meet the conditions specified at the time of their creation.

Integrations need to implement their own UI for Bet Boost management (potentially in their back office) and may utilize our Dictionary API to populate some condition values. To define Bet Boost conditions, integrations must include the following conditions when calling the POST /bet-boosts endpoint during creation, and the PUT /bet-boosts/{boostID} endpoint for updates:

Conditions

List of all conditions

A general list of available conditions. The specific set of supported conditions for each condition type and bet type is documented in the OpenAPI specification.

TypeConditionDescription
BetDetails type [single, express, system] Type of bet. Types of bets are described in detail on the page: types of bets.
odds_count Range for number of selections in a bet. NOTE: Not applicable for the single bet type.
bet_builder_odds_count Range for number of Bet Builder selections in a bet. (values max, min).
bet_builder_inner_odds_count Range for number of inner selections in a Bet Builder bet.
total_odds_value Range for the total combined odds for the bet. NOTE: Not applicable for the single bet type.
system_size Range of elements in a system bet array. For system S[2,3] size would be 2, for system S[2] size would be 1. NOTE: Applicable only for the system bet type.
combinations_count Range for number of combinations in a system bet (specify as min-max values). NOTE: Applicable only for the system bet type.
odd_value Range of odds for individual selections.
sport Specific sport IDs. Bet Boost can only be used on events within these sports.
tournament Specific tournament IDs. Bet Boost can only be used on events within these tournaments.
sport_event Specific sport event IDs. Bet Boost can only be used on these exact events.
sport_event_state Specific sport event states. Bet Boost can only be used on these exact event states.
market_type Specific market type IDs. Bet Boost can only be used on these bet markets (e.g., match winner, total goals).
competitor Specific competitor IDs. Bet Boost can only be used on events where these teams/players participate.
stake_amount_range Range of the bet amount (values `max`, `min`).
hot_bundle If selections 100% matched one of Hot Bundles that was displayed to user.

Calculation Strategy

The calculation_strategy field defines how the boost multiplier is calculated and which multiplier scale is displayed in the frontend.

Each strategy also has its own conditions block that determines which selections are eligible to contribute to the multiplier calculation (separate from the top-level bet conditions that gate whether the boost can be used at all).

TypeDescriptionParams
static A fixed multiplier is applied when the required number of eligible selections is met. The multiplier does not grow with more selections — it is either active or not. The frontend shows a static scale.
  • multiplier — fixed boost multiplier value (e.g. 1.15)
  • min_selections — minimum number of eligible selections required for the multiplier to apply (must be ≥ 1)
steps The multiplier grows incrementally with each completed step. A step is completed when the player adds the required number of eligible selections. The frontend shows a step scale.
  • selections_per_step — number of eligible selections needed to complete one step
  • multiplier_per_step — additive increment added to the multiplier per step (e.g. 0.05 means the multiplier increases by 0.05 for each step)
  • max_multiplier — maximum allowed boost multiplier
margin The multiplier is derived from the bookmaker's margin of the eligible selections. The higher the combined odds of the eligible selections, the more margin is applied to the multiplier, up to the defined maximum. The frontend shows a range scale.
  • max_multiplier — maximum allowed boost multiplier
  • min_marge_ratio — minimum margin ratio used when calculating the multiplier
  • max_marge_ratio — maximum margin ratio that can be applied

API