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

Examples

The following examples show complete calculation_strategy, required_conditions, and applicable_conditions payloads for each strategy type. They can be sent to the POST /bet-boosts and PUT /bet-boosts/{boostID} endpoints.

Keep in mind the difference between the two condition blocks, because together they decide what the player experiences:

  • required_conditions gate whether the boost is shown to the player at all. If the coupon does not satisfy them, the boost stays hidden.
  • applicable_conditions decide which odds the multiplier is applied to. A boost can be shown (required conditions met) yet still be inactive if none of the coupon's odds satisfy the applicable conditions.

Reward players for building a football Combo across Europe's top competitions. The boost is offered on any qualifying football Combo, so the player sees it as soon as they start a suitable coupon — but the growing multiplier only rewards selections from the Champions League, Europa League, and La Liga. Every qualifying selection adds another step, raising the multiplier by 0.25 up to 2.0 (1.25 → 1.50 → 1.75 → 2.0).

  • Required (boost shown): Combo bet, football only, 3–10 selections, each odd ≥ 1.40, stake between 100 and 5000.
  • Applicable (multiplier applied to): Only odds from the Champions League / Europa League / La Liga tournaments, and only match result (1), totals (18), or handicap (29) market types.
  • Calculation conditions: All eligible odds must be prematch and from those specific tournaments.

What the player sees in different cases:

Player's coupon Boost shown? Active? What the multiplier applies to
Champions League football match ✅ yes ✅ yes the Champions League match odds
Other football match (not CL / EL / La Liga) ✅ yes ❌ no nothing — no eligible tournament odds
Champions League + other football ✅ yes ✅ yes only the Champions League odds
Tennis / another sport only ❌ no (hidden) — — 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
{
  "calculation_strategy": {
    "type": "steps",
    "strategy": {
      "conditions": [
        {
          "type": "bet_details",
          "bet_details": [
            {
              "type": "express",
              "data": {
                "tournament": {
                  "type": "tournament",
                  "match_all_odds": true,
                  "tournament_ids": [
                    "betting:20:sr:tournament:7",
                    "betting:20:sr:tournament:8",
                    "betting:20:sr:tournament:35"
                  ]
                },
                "sport_event_state": {
                  "type": "sport_event_state",
                  "match_all_odds": true,
                  "sport_event_states": ["prematch"]
                }
              }
            }
          ]
        }
      ],
      "params": {
        "selections_per_step": 1,
        "multiplier_per_step": "0.25",
        "max_multiplier": "2.0"
      }
    }
  },
  "required_conditions": [
    {
      "type": "bet_details",
      "bet_details": [
        {
          "type": "express",
          "data": {
            "sport": {
              "type": "sport",
              "match_all_odds": true,
              "sport_ids": ["football"]
            },
            "odds_count": {
              "type": "odds_count",
              "min": 3,
              "max": 10
            },
            "odd_value": {
              "type": "odd_value",
              "min": "1.40",
              "match_all_odds": true
            },
            "stake_amount_range": {
              "type": "stake_amount_range",
              "min": "100.00",
              "max": "5000.00"
            }
          }
        }
      ]
    }
  ],
  "applicable_conditions": [
    {
      "type": "bet_details",
      "bet_details": [
        {
          "type": "express",
          "data": {
            "tournament": {
              "type": "tournament",
              "match_all_odds": true,
              "tournament_ids": [
                "betting:20:sr:tournament:7",
                "betting:20:sr:tournament:8",
                "betting:20:sr:tournament:35"
              ]
            },
            "market_type": {
              "type": "market_type",
              "match_all_odds": true,
              "market_types": [1, 18, 29]
            }
          }
        }
      ]
    }
  ]
}

Give a flat reward for backing a single big Bet Builder on one specific match. The player sees the boost whenever they build a qualifying single Bet Builder coupon on that event, and a fixed 1.50 multiplier kicks in as soon as at least 3 eligible selections are present — it does not grow with more selections.

  • Required (boost shown): Single bet with a Bet Builder (3–6 inner odds per builder), total odds ≥ 3.00, the specific event, football or basketball.
  • Applicable (multiplier applied to): Only odds from the specific event (6d6dca8d-8bc6-44d2-946c-125d1fc8a872).
  • Calculation conditions: None — the static multiplier needs no additional strategy conditions.

What the player sees in different cases:

Player's coupon Boost shown? Active? What the multiplier applies to
Single Bet Builder on the target event, 3–6 legs, total odds ≥ 3.00 ✅ yes ✅ yes the Bet Builder odds (fixed 1.50×)
Single Bet Builder on the target event, but total odds < 3.00 ❌ no (hidden) — —
Bet Builder on a different event, or a single without a Bet Builder ❌ no (hidden) — —
Combo / System bet, or another sport ❌ no (hidden) — — 
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
{
  "calculation_strategy": {
    "type": "static",
    "strategy": {
      "conditions": [],
      "params": {
        "multiplier": "1.50",
        "min_selections": 3
      }
    }
  },
  "required_conditions": [
    {
      "type": "bet_details",
      "bet_details": [
        {
          "type": "single",
          "data": {
            "sport": {
              "type": "sport",
              "match_all_odds": false,
              "sport_ids": ["football", "basketball"]
            },
            "sport_event": {
              "type": "sport_event",
              "match_all_odds": true,
              "sport_event_ids": ["6d6dca8d-8bc6-44d2-946c-125d1fc8a872"]
            },
            "bet_builder_odds_count": {
              "type": "bet_builder_odds_count",
              "min": 1
            },
            "bet_builder_inner_odds_count": {
              "type": "bet_builder_inner_odds_count",
              "min": 3,
              "max": 6,
              "match_all_odds": true
            },
            "total_odds_value": {
              "type": "total_odds_value",
              "min": "3.00"
            }
          }
        }
      ]
    }
  ],
  "applicable_conditions": [
    {
      "type": "bet_details",
      "bet_details": [
        {
          "type": "single",
          "data": {
            "sport_event": {
              "type": "sport_event",
              "match_all_odds": true,
              "sport_event_ids": ["6d6dca8d-8bc6-44d2-946c-125d1fc8a872"]
            }
          }
        }
      ]
    }
  ]
}

Drive live System bets on a specific CS:GO tournament featuring two flagship teams. The boost is shown when the player builds a qualifying live CS:GO System coupon involving those teams, and the multiplier is derived from the bookmaker's margin on the eligible odds — the more margin those selections carry, the higher the multiplier climbs, up to 3.0 (margin ratio between 2% and 30%).

  • Required (boost shown): System bet (size 2–3, ≥ 3 combinations), CS:GO only, live events, specific teams involved, 3–6 selections, stake between 50 and 2000.
  • Applicable (multiplier applied to): Only odds from tournament 23911, match result (1) / map winner (572) / round handicap (295) markets, and must be a hot bundle.
  • Calculation conditions: CS:GO sport, all eligible odds within the 1.20–10.00 range.

What the player sees in different cases:

Player's coupon Boost shown? Active? What the multiplier applies to
Live CS:GO System with the two teams; eligible odds from tournament 23911 in a hot bundle ✅ yes ✅ yes the tournament 23911 hot-bundle odds (margin-based)
Live CS:GO System with the two teams, but odds from another tournament or not a hot bundle ✅ yes ❌ no nothing — no eligible odds
Live CS:GO System mixing eligible 23911 hot-bundle odds + other CS:GO odds ✅ yes ✅ yes only the eligible tournament 23911 odds
Prematch CS:GO, a Single / Combo bet, or another sport ❌ no (hidden) — — 
  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
{
  "calculation_strategy": {
    "type": "margin",
    "strategy": {
      "conditions": [
        {
          "type": "bet_details",
          "bet_details": [
            {
              "type": "system",
              "data": {
                "sport": {
                  "type": "sport",
                  "match_all_odds": true,
                  "sport_ids": ["esports_counter_strike"]
                },
                "odd_value": {
                  "type": "odd_value",
                  "min": "1.20",
                  "max": "10.00",
                  "match_all_odds": true
                }
              }
            }
          ]
        }
      ],
      "params": {
        "max_multiplier": "3.0",
        "min_marge_ratio": "0.02",
        "max_marge_ratio": "0.30"
      }
    }
  },
  "required_conditions": [
    {
      "type": "bet_details",
      "bet_details": [
        {
          "type": "system",
          "data": {
            "sport": {
              "type": "sport",
              "match_all_odds": true,
              "sport_ids": ["esports_counter_strike"]
            },
            "sport_event_state": {
              "type": "sport_event_state",
              "match_all_odds": false,
              "sport_event_states": ["live"]
            },
            "competitor": {
              "type": "competitor",
              "match_all_odds": false,
              "competitor_ids": [
                {
                  "identifier": "betting:0:47-esports_counter_strike",
                  "type": 2
                },
                {
                  "identifier": "betting:0:52-esports_counter_strike",
                  "type": 2
                }
              ]
            },
            "odds_count": {
              "type": "odds_count",
              "min": 3,
              "max": 6
            },
            "system_size": {
              "type": "system_size",
              "min": 2,
              "max": 3
            },
            "combinations_count": {
              "type": "combinations_count",
              "min": 3
            },
            "stake_amount_range": {
              "type": "stake_amount_range",
              "min": "50.00",
              "max": "2000.00"
            }
          }
        }
      ]
    }
  ],
  "applicable_conditions": [
    {
      "type": "bet_details",
      "bet_details": [
        {
          "type": "system",
          "data": {
            "tournament": {
              "type": "tournament",
              "match_all_odds": true,
              "tournament_ids": ["betting:20:sr:tournament:23911"]
            },
            "market_type": {
              "type": "market_type",
              "match_all_odds": false,
              "market_types": [1, 572, 295]
            },
            "hot_bundle": {
              "type": "hot_bundle",
              "match": true
            }
          }
        }
      ]
    }
  ]
}

API