Bet Settle

Event Key

ootb_sports_bet_settle

This event should be sent each time a sports bet is settled by the operator.

Event KeyEvent NameType
ootb_sports_bet_settleOOTB Sports Bet SettleSimple 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 Bet Settle event:

 {
    "context": {
      "ootb_betslip_key": "cniowfh0193duf879cn2",
      "ootb_bet_date_time": "2024-05-27T10:30:00Z",
      "ootb_settled_date_time": "2024-05-27T10:30:00Z",
      "ootb_betslip_status": "close",
      "ootb_platform": "iOS",
      "ootb_channel": "mobile",
      "ootb_license": "licenseXYZ",
      "ootb_bet_key": "selection789",
      "ootb_bet_stake": 100.00,
      "ootb_bet_payout": 150.00,
      "ootb_bet_bonus": 0.00,
      "ootb_bet_sel_stake": 50.00,
      "ootb_bet_sel_payout": 75.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_leg_status": "Won",
      "ootb_each_way": "Yes",
      "ootb_bet_type": "Multiple",
      "ootb_num_selections": 2,
      "ootb_brand": "skin123"
    }
  } 

Parameters

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

Explanation

  • event: Set to ootb_sports_bet_settle to indicate a settled 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 the bet slip, individual bet, selection, market, event, competition (meeting), competition 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 key.
    • ootb_bet_date_time, ootb_settled_date_time, ootb_betslip_status: Capture when the bet was placed, when it was settled, and the final status of the bet slip.
    • ootb_bet_stake, ootb_bet_payout, ootb_bet_bonus, ootb_bet_sel_stake, ootb_bet_sel_payout, ootb_bet_sel_bonus: Monetary amounts for total and per-selection stake, payout, and bonus.
    • ootb_odds_num, ootb_odds_den, ootb_dec_price, ootb_american_price: Provide odds in fractional, decimal, and American formats for flexible downstream processing.
    • ootb_leg_num, ootb_leg_type, ootb_leg_status, ootb_each_way, ootb_bet_type, ootb_num_selections: Describe bet structure and outcome details.
    • ootb_is_live: Flag indicating whether the bet was placed or settled during a live event.
    • ootb_platform, ootb_channel, ootb_license, ootb_brand: Standard metadata for segmentation and analysis (client platform, channel, regulatory license, brand/skin).