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 Key	Event Name	Type
`ootb_sports_bet_placed`	OOTB Sports Bet Placed	Simple 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_number": 5,
    "ootb_odds_denominator": 1,
    "ootb_odds_decimal_price": 6.00,
    "ootb_odds_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 Key	Parameter Name	Type	Description	Mandatory for Opti-X?
`ootb_betslip_key`	Bet Slip Key	String	Identifier for the bet slip or ticket (group of bets).	Yes
`ootb_bet_date_time`	Bet Date Time	Timestamp	UTC timestamp when the bet was placed.	Yes
`ootb_betslip_status`	Bet Slip Status	String	Status of the bet slip (`open`, `win`, `loss`).	Yes
`ootb_platform`	Platform	String	Platform from which the bet was placed (e.g., iOS, Android).	No
`ootb_channel`	Channel	String	Channel used for the bet (e.g., mobile, web).	No
`ootb_license`	License	String	Regulatory license identifier.	No
`ootb_bet_key`	Bet Key	String	Unique identifier for the individual bet.	Yes
`ootb_bet_stake`	Bet Stake	Number	Total cash stake amount for the bet.	Yes
`ootb_bet_bonus`	Bet Bonus	Number	Bonus amount included in the stake (e.g., free bet).	No
`ootb_bet_sel_stake`	Bet Selection Stake	Number	Stake amount allocated to this selection.	No
`ootb_bet_sel_bonus`	Bet Selection Bonus	Number	Bonus amount allocated to this selection.	No
`ootb_is_live`	Is Live	Boolean	`1` if the bet was placed during a live event; `0` otherwise.	No
`ootb_odds_number`	Odds Numerator	Number	Fractional numerator for the selection odds.	No
`ootb_odds_denominator`	Odds Denominator	Number	Fractional denominator for the selection odds.	No
`ootb_odds_decimal_price`	Decimal Odds Price	Number	Decimal (European) price for the selection odds.	Yes
`ootb_odds_american_price`	American Odds Price	Number	American odds price for the selection odds.	No
`ootb_selection_key`	Selection Key	String	Unique ID for the selection in the operator’s database.	Yes
`ootb_selection_name`	Selection Name	String	Name of the chosen selection (e.g., Manchester United).	Yes
`ootb_market_key`	Market Key	String	Unique ID for the market in the operator’s database.	Yes
`ootb_market_name`	Market Name	String	Name of the market (e.g., Match Result).	Yes
`ootb_event_date_time`	Event Date Time	Timestamp	UTC timestamp of the scheduled start time of the sporting event.	Yes
`ootb_event_key`	Event Key	String	Unique ID for the sporting event.	Yes
`ootb_event_name`	Event Name	String	Name of the sporting event (e.g., Man Utd vs Liverpool).	Yes
`ootb_meeting_key`	Meeting Key	String	Unique ID for the competition or league.	Yes
`ootb_meeting_name`	Meeting Name	String	Name of the competition (e.g., Premier League).	Yes
`ootb_class_key`	Class Key	String	Unique ID for the competition category.	Yes
`ootb_class_name`	Class Name	String	Name of the competition category (e.g., English).	Yes
`ootb_discipline_key`	Discipline Key	String	Unique ID for the sport.	Yes
`ootb_discipline_name`	Discipline Name	String	Name of the sport (e.g., football).	Yes
`ootb_leg_num`	Leg Number	Number	Position of this selection within a multi-leg bet.	Yes
`ootb_leg_type`	Leg Type	String	Type of leg (e.g., To win, Handicap, Outright).	No
`ootb_each_way`	Each Way	Boolean	Yes for win & place bets (common in horse racing).	No
`ootb_bet_type`	Bet Type	String	Bet structure (Multiple, Single, System, Bet Builder).	Yes
`ootb_is_free`	Is Free Bet	Boolean	`true` if the bet was funded solely by bonus credit; `false` otherwise.	No
`ootb_num_selections`	Number of Selections	Number	Number of selections in the bet (e.g., 2 for a double).	Yes
`ootb_brand`	Brand	String	Brand or “skin” under which the bet was placed.	No

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_number, ootb_odds_denominator, ootb_odds_decimal_price, ootb_odds_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).