Events tracking the lifecycle of a sports wager.
add_to_betslip
Triggered when a selection is added to the user's betslip (pre-purchase).
Example Payload
{
"event": "add_to_betslip",
"timestamp": "2025-08-17T14:10:00Z",
"user_id": "user123",
"value": {
"bet_id": "B123456789",
"bet_type": "multi",
"number_of_legs": 2,
"odds": "2.50",
"stake_cash": 50.00,
"stake_bonus": 0,
"stake_total": 50.00,
"potential_return": 125.00,
"live_betting": false,
"bonus_applied": false,
"bonus_id": "BN789012345",
"legs": [
{
"leg_id": 1,
"event_name": "Manchester United v Liverpool",
"sport": "Football",
"competition": "Premier League",
"participants": ["Manchester United", "Liverpool"]
"market": "Match Result",
"selection": "Liverpool Win",
"event_start_time": "2025-08-17T17:30:00Z"
}
{
"leg_id": 2,
"event_name": "Dunstable 2pm",
"sport": "Horse Racing",
"competition": "Daily Dunstable Chase",
"participants": []
"market": "Race Result",
"selection": "Big Spoon to Win",
"event_start_time": "2025-09-27T14:00:00Z"
}
]
}
}
bet_placed
Triggered when a bet is successfully confirmed and funds are deducted.
Example Payload
{
"event": "bet_placed",
"timestamp": "2025-08-17T14:10:00Z",
"user_id": "user123",
"value": {
"bet_id": "B123456789",
"bet_type": "multi",
"number_of_legs": 2,
"odds": "2.50",
"stake_cash": 50.00,
"stake_bonus": 0,
"stake_total": 50.00,
"potential_return": 125.00,
"live_betting": false,
"bonus_applied": false,
"bonus_id": "BN789012345",
"legs": [
{
"leg_id": 1,
"event_name": "Manchester United v Liverpool",
"sport": "Football",
"competition": "Premier League",
"participants": ["Manchester United", "Liverpool"]
"market": "Match Result",
"selection": "Liverpool Win",
"event_start_time": "2025-08-17T17:30:00Z"
}
{
"leg_id": 2,
"event_name": "Dunstable 2pm",
"sport": "Horse Racing",
"competition": "Daily Dunstable Chase",
"participants": []
"market": "Race Result",
"selection": "Big Spoon to Win",
"event_start_time": "2025-09-27T14:00:00Z"
}
]
"balance_cash": 1100.00,
"balance_bonus": 200.00,
"balance_total": 1300.00
}
}
bet_settled
Triggered when the outcome of the sports event is determined.
Example Payload
{
"event": "bet_settled",
"timestamp": "2025-08-17T14:10:00Z",
"user_id": "user123",
"value": {
"bet_id": "B123456789",
"bet_type": "multi",
"number_of_legs": 2,
"odds": "2.50",
"stake_cash": 50.00,
"stake_bonus": 0,
"stake_total": 50.00,
"potential_return": 125.00,
"actual_return": 125.00,
"settlement_status": "won",
"live_betting": false,
"bonus_applied": false,
"bonus_id": "BN789012345",
"legs": [
{
"leg_id": 1,
"event_name": "Manchester United v Liverpool",
"sport": "Football",
"competition": "Premier League",
"participants": ["Manchester United", "Liverpool"]
"market": "Match Result",
"selection": "Liverpool Win",
"event_start_time": "2025-08-17T17:30:00Z"
"result": "won"
}
{
"leg_id": 2,
"event_name": "Dunstable 2pm",
"sport": "Horse Racing",
"competition": "Daily Dunstable Chase",
"participants": []
"market": "Race Result",
"selection": "Big Spoon to Win",
"event_start_time": "2025-09-27T14:00:00Z"
"result": "won"
}
]
"balance_cash": 1225.00,
"balance_bonus": 200.00,
"balance_total": 1425.00
}
}