Bet Placement

Event Key

ootb_sports_bet_placed

This event should be sent each time a sports bet is placed and approved by the operator.

Event KeyEvent NameType
ootb_sports_bet_placedOOTB Sports Bet PlacedSimple event

Event Structure

The mandatory properties (tenant, timestamp, event, and customer) are required for all events and documented in detail on the Mandatory Properties page.Below is the JSON structure for the context-specific properties of the Sports Bet Placed event:

{
  "context": {
    "ootb_betslip_key": "cniowfh0193duf879cn2",
    "ootb_bet_date_time": "2024-05-27T10:30:00Z",
    "ootb_betslip_status": "open",
    "ootb_platform": "iOS",
    "ootb_channel": "mobile",
    "ootb_license": "licenseXYZ",
    "ootb_bet_key": "selection789",
    "ootb_bet_stake": 100.00,
    "ootb_bet_bonus": 0.00,
    "ootb_bet_sel_stake": 50.00,
    "ootb_bet_sel_bonus": 0.00,
    "ootb_is_live": 1,
    "ootb_odds_num": 5,
    "ootb_odds_den": 1,
    "ootb_dec_price": 6.00,
    "ootb_american_price": -120,
    "ootb_selection_key": "3647893264",
    "ootb_selection_name": "Manchester United",
    "ootb_market_key": "3647893264",
    "ootb_market_name": "Match Result",
    "ootb_event_date_time": "2024-05-27T10:30:00Z",
    "ootb_event_key": "67967899",
    "ootb_event_name": "Manchester United vs Liverpool",
    "ootb_meeting_key": "67839642",
    "ootb_meeting_name": "Premier League",
    "ootb_class_key": "67839642",
    "ootb_class_name": "English",
    "ootb_discipline_key": "13",
    "ootb_discipline_name": "football",
    "ootb_leg_num": 1,
    "ootb_leg_type": "To win",
    "ootb_each_way": "Yes",
    "ootb_bet_type": "Multiple",
    "ootb_is_free": false,
    "ootb_num_selections": 2,
    "ootb_brand": "skin123"
  }
}

Parameters

Parameter KeyParameter NameTypeDescription
ootb_betslip_keyBet Slip KeyStringIdentifier for the bet slip or ticket (group of bets).
ootb_bet_date_timeBet Date TimeTimestampUTC timestamp when the bet was placed.
ootb_betslip_statusBet Slip StatusStringStatus of the bet slip (open, win, loss).
ootb_platformPlatformStringPlatform from which the bet was placed (e.g., iOS, Android).
ootb_channelChannelStringChannel used for the bet (e.g., mobile, web).
ootb_licenseLicenseStringRegulatory license identifier.
ootb_bet_keyBet KeyStringUnique identifier for the individual bet.
ootb_bet_stakeBet StakeNumberTotal cash stake amount for the bet.
ootb_bet_bonusBet BonusNumberBonus amount included in the stake (e.g., free bet).
ootb_bet_sel_stakeBet Selection StakeNumberStake amount allocated to this selection.
ootb_bet_sel_bonusBet Selection BonusNumberBonus amount allocated to this selection.
ootb_is_liveIs LiveBoolean1 if the bet was placed during a live event; 0 otherwise.
ootb_odds_numOdds NumeratorNumberFractional numerator for the selection odds.
ootb_odds_denOdds DenominatorNumberFractional denominator for the selection odds.
ootb_dec_priceDecimal Odds PriceNumberDecimal (European) price for the selection odds.
ootb_american_priceAmerican Odds PriceNumberAmerican odds price for the selection odds.
ootb_selection_keySelection KeyStringUnique ID for the selection in the operator’s database.
ootb_selection_nameSelection NameStringName of the chosen selection (e.g., Manchester United).
ootb_market_keyMarket KeyStringUnique ID for the market in the operator’s database.
ootb_market_nameMarket NameStringName of the market (e.g., Match Result).
ootb_event_date_timeEvent Date TimeTimestampUTC timestamp of the scheduled start time of the sporting event.
ootb_event_keyEvent KeyStringUnique ID for the sporting event.
ootb_event_nameEvent NameStringName of the sporting event (e.g., Man Utd vs Liverpool).
ootb_meeting_keyMeeting KeyStringUnique ID for the competition or league.
ootb_meeting_nameMeeting NameStringName of the competition (e.g., Premier League).
ootb_class_keyClass KeyStringUnique ID for the competition category.
ootb_class_nameClass NameStringName of the competition category (e.g., English).
ootb_discipline_keyDiscipline KeyStringUnique ID for the sport.
ootb_discipline_nameDiscipline NameStringName of the sport (e.g., football).
ootb_leg_numLeg NumberNumberPosition of this selection within a multi-leg bet.
ootb_leg_typeLeg TypeStringType of leg (e.g., To win, Handicap, Outright).
ootb_each_wayEach WayBooleanYes for win & place bets (common in horse racing).
ootb_bet_typeBet TypeStringBet structure (Multiple, Single, System).
ootb_is_freeIs Free BetBooleantrue if the bet was funded solely by bonus credit; false otherwise.
ootb_num_selectionsNumber of SelectionsNumberNumber of selections in the bet (e.g., 2 for a double).
ootb_brandBrandStringBrand or “skin” under which the bet was placed.

Explanation

  • event: Set to ootb_sports_bet_placed to indicate a placed & approved sports bet.
  • context:
    • ootb_betslip_key, ootb_bet_key, ootb_selection_key, ootb_market_key, ootb_event_key, ootb_meeting_key, ootb_class_key, ootb_discipline_key: Link to your operator’s database identifiers for bet slip, individual bet, selection, market, event, competition (meeting), category (class) and sport (discipline).
    • ootb_selection_name, ootb_market_name, ootb_event_name, ootb_meeting_name, ootb_class_name, ootb_discipline_name: Human-readable names corresponding to each of the above keys.
    • ootb_bet_date_time, ootb_event_date_time, ootb_betslip_status: Capture when the bet was placed, when the event starts, and the current status of the bet slip.
    • ootb_bet_stake, ootb_bet_bonus, ootb_bet_sel_stake, ootb_bet_sel_bonus: Monetary amounts for the overall stake and bonus and per-selection stake and bonus.
    • ootb_odds_num, ootb_odds_den, ootb_dec_price, ootb_american_price: Provide odds in fractional (numerator/denominator), decimal, and American formats for flexible downstream processing.
    • ootb_leg_num, ootb_leg_type, ootb_each_way, ootb_bet_type, ootb_num_selections: Describe complex bet structures (leg ordering, type of leg, each-way bets, bet type, number of selections).
    • ootb_is_live, ootb_is_free: Flags indicating whether the bet was placed in-play and whether it was funded solely by bonus credit.
    • ootb_platform, ootb_channel, ootb_license, ootb_brand: Standard metadata for segmentation and analysis (client platform, channel, regulatory license, brand/skin).