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
- The integration client creates a Bet Boost through the API.
- The player can view available Bet Boosts in the SPA and place a bet with a selected Bet Boost applied.
- The integration receives the
bet_boost_idfield in the /bet/place callback. - If the bet is accepted:
bet_boost_idis 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.
- The integration receives the
- 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_amountfield 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.
- When the bet is won, the
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 send the following conditions in the POST /boosts/create during creation, and POST /boosts/update methods:
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.
| Type | Condition | Description |
|---|---|---|
| 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. | |
| 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. | |
| 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`). |