Swipe Bet widget is a front-end widget that provides a personalized betting experience and a fun way for punters to create multi bets. The main feature is the user interface that allows punters to quickly add selections to the bet slip by swiping event cards to the right and removing events they are not interested in by swiping left.
Personalization requirement
To enable personalized recommendations (the recommended type), you must provide a unique user identifier. When no user ID is provided, the widget will fall back to popular recommendations.
Fun, "swipe-to-bet" interaction style that increases user session duration and engagement.
Tailors a list of high-relevance betting opportunities based on individual punter history.
Surface interesting matches and markets that users might otherwise overlook in traditional menus.
Supports real-time swiping for live events and discovery for upcoming pre-match fixtures.
Minimal technical overhead required to embed this innovative betting feature.
Complete control over visual elements and interaction cues to fit your platform's USP.
Tinder-like navigation: swipe right to add to bet slip, swipe left to dismiss and see the next idea.
Opens in an elegant overlay, allowing users to browse bets without losing their place on your site.
Seamlessly combine selections from multiple swiped cards into a high-value accumulator.
Place the launch button anywhere—from the home page to specific tournament or profile sections.
Access to the client API
Required endpoints: User ID, Odds, Bet slip content, combined odds for multi bets
Requires an adapter to be registered via SIR('registerAdapter', '{ADAPTER_NAME}'). See the adapter overview: https://apidocs.sportradar.online/resources/widgets/docs/adapter/Overview
widget-name: betRecommendation.swipeBet
Environment Requirements
Supported Sports
See the Swipe Bet widget demo. Illustrations of main interaction modes and configurations with relevant property values below.

Full-screen mobile interface with swipe gestures for rapid bet selection.
| Property | Type | Default | Description |
|---|---|---|---|
user | string|number | 0 | User identifier for personalized recommendations. |
buttonTitle | string|false | "Swipe Bet" | Text displayed on button trigger. |
productTitle | string | "SWIPE BET" |
| Title displayed in widget header. |
headerIcon | string | undefined | Custom icon URL for widget header. |
buttonIcon | string|false | undefined | Custom icon URL for button trigger. |
maxSelectionsMultiMode | number | 12 | Maximum selections in multi bet mode (1-20). |
maxSelectionsSingleMode | number | 12 | Maximum selections in single bet mode (1-20). |
isMobile | boolean | false | Rendering mode (mobile or desktop). |
betSlipMode | array<string> | ["multi"] | Available betting modes: "single", "multi", or both. |
outcomeNamePosition | string | "start" | Outcome label position: "start", "end", "top", or "bottom". |
customLoaderImg | string | undefined | URL for custom loading image. |
customLoaderMs | number | 250 | Duration to display custom loader (ms). |
onItemClick | function | undefined | Callback for user interactions. |
Extended Properties
| Property | Type | Default | Description |
|---|---|---|---|
filters | object | Required | Configuration object for sport and time filters. See below for detailed structure. |
disableLazyLoad | boolean | false | Controls lazy loading behavior. When true, widget content loads immediately on page load instead of deferring until user interaction. Set true for standalone mode or when immediate display required. Default false optimizes initial page performance. |
sportsMapping | object | undefined | Maps client's sport identifiers to Sportradar sport IDs. Object with keys as client sport IDs (string/number) and values as Sportradar sport IDs. Example: {101: 1, 102: 2} maps client IDs 101/102 to soccer/basketball. |
customJerseys | object | undefined | Custom team jersey/logo images for match cards. Nested object structure: {sportId: {tournamentId: {teams: {teamId: {home: url, away: url}}, default: {home: url, away: url}}}}. Allows branded team visuals per sport and tournament. |
debug | boolean | false | Enables debug mode with console logging for development. When true, logs recommendation fetch, swipe actions, bet selections, errors. Use for troubleshooting integration issues. |
The filters object controls available sports and time ranges for bet recommendations.
| Property | Type | Default | Description |
|---|---|---|---|
sport | object | Required | Sport filter configuration. |
sport.available | array<string|number> | [] | Required. Array of Sportradar sport IDs to include in recommendations. Empty array shows all available sports. Example: [1, 2, 5] for soccer, basketball, tennis. See Sports Reference. |
time | object | Required | Time filter configuration. |
time.available |
{
sport: {
available: [1, 2, 5, 23] // Soccer, Basketball, Tennis, Volleyball
},
time: {
available: "not_started", // Upcoming events only
range: 24 // Next 24 hours
}
}Theming customization allows to tailor the appearance of Bet Recommendation widgets to meet specific needs and preferences. In the context of the Bet Recommendation widget, customization refers to the ability to modify the default styling of the widget by applying custom CSS properties to the various HTML elements that make up the widget.
Widget comes with pre-existing styling but can be customized by applying custom CSS properties to its different HTML elements. The widget's custom class selectors and supported CSS properties are listed below.
All custom classes must be nested within the .sr-bb.sr-swipebet selector class. This ensures that the custom styles only apply to that widget and not to other elements on the page.
Custom class selectors
| CSS class | Supported CSS properties |
|---|---|
srct-br-container | background-color, font-family |
srct-br-header | background-color, color, border-radius |
srct-br-header__title | font-size, color |
srct-br-header__divider | border-color |
srct-br-content__title | font-weight |
srct-br-footer | font-size, color, background-color, border-radius |
srct-br-loading | background-color, border-radius |
srct-br-navigation | background-color, color |
srct-br-card | background-color, color, border-radius |
srct-br-card__divider | border-color |
srct-br-outcome | background-color, color, border-radius, border |
srct-br-outcome--selected | background-color, color, border-radius, border |
srct-br-outcome--disabled | background-color, color, border-radius |
srct-br-outcome__name | font-size, color, opacity |
srct-br-outcome__value | font-size, color, font-weight |
srct-br-eventinfo | font-size, color |
srct-br-eventinfo__icon | color |
srct-br-eventinfo__time | font-size, color |
srct-br-eventinfo__status | font-size, color |
srct-br-eventinfo__name | font-size, color |
srct-br-scoreboard | font-size, color |
srct-br-scoreboard__teams | font-size, color |
srct-br-scoreboard__scores | font-size, color |
srct-br-customjersey | mask-image |
srct-br-widgetbutton | font-size, color, border-radius, padding, background-color |
srct-br-widgetbutton__icon | height, width |
srct-br-closebutton | font-size, color, border-radius, background-color |
srct-br-thumb | background-color, border-radius |
srct-br-thumb--like | background-color, border-radius |
srct-br-thumb--dislike | background-color, border-radius |
srct-br-thumb--active | background-color, border-radius |
srct-br-thumb--disabled | background-color, border-radius |
srct-br-thumb__icon | color |
srct-br-thumb__icon--active | color |
srct-br-thumb__icon--disabled | color |
srct-br-thumb__icon--like | color |
srct-br-thumb__icon--dislike | color |
srct-br-bet-counter | color, background-color |
srct-br-marketselectionbutton | font-size, color, border-radius, border-color, background-color |
srct-br-marketselectionbutton--disabled | font-size, color, border-radius, border-color, background-color |
srct-br-market__name | font-size, color |
srct-br-market__change-text | font-size, color |
srct-br-market__change-icon | width, height |
srct-br-betslipbutton | font-size, color, border, border-radius, background-color, opacity |
Mandatory Configuration
The filters property is required for this widget to function correctly. It defines the recommendation logic and basic data constraints.

Demo: Open demo
The onItemClick callback is fired whenever the user interacts with the widget. The first argument is a target string that identifies the interaction type; the second argument is a data object containing contextual information.
target value | Trigger | Key data properties |
|---|---|---|
"externalOutcome" | User clicks a single outcome button | externalEvent, externalMarket, externalOutcome |
"externalOutcomes" | User clicks multiple outcomes at once (e.g. combo card) | Array of { externalEvent, externalMarket, externalOutcome } |
"externalEvent" | User clicks an event header/card | externalEvent |
"externalCompetition" | User clicks a competition/league name | externalCompetition |
"goToBetSlip" | User clicks the "Go to Bet Slip" button (swipeBet only) | — |
"betSlipMode" | Bet slip mode changes between single and multi (swipeBet only) | value: "single" | "multi" |
SIR("addWidget", "#sr-widget", "betRecommendation.markets", {
onItemClick: function (target, data) {
if (target === "externalOutcome") {
// Add single outcome to bet slip
const { externalEvent, externalMarket, externalOutcome } =
Note: Widgets support callbacks on outcome clicks — the onItemClick handler receives target === "outcome" and a data object containing externalEvent, externalMarket and externalOutcome. Use this for custom outcome callbacks (e.g., add-to-betslip, analytics, modals).
The widget also exposes onTrack for event tracking analytics. See the tracking guide for details.
The onTotalOddsChanged adapter method lets you provide pre-calculated total odds for combo tickets displayed in the widget (used by My Combo and Swipe Bet). When a user's selection changes, the widget calls this method with the current set of outcomes and expects you to return the computed total odds.
Register it alongside your adapter:
function onTotalOddsChanged(args, callback) {
// Replace with your own odds calculation implementation
const oddsResponse = getOdds(args);
callback(oddsResponse);
}
SIR("registerAdapter", "{ADAPTER_NAME}", {
onTotalOddsChanged: onTotalOddsChanged,
});
SIR("addWidget", "#sr-widget", "betRecommendation.myCombo");OddsRequest — passed to onTotalOddsChanged as args:
| Property | Type | Description |
|---|---|---|
odds | Array<Outcome> | Array of outcomes whose combined odds should be returned. |
Outcome (item in odds array):
| Property | Type | Description |
|---|---|---|
eventId | string | Sportradar event ID. |
outcomeId | string | Sportradar outcome ID. |
marketId | string | Sportradar market ID. |
specifier | string | Market specifier value. |
OddsResponse — returned via callback:
| Property | Type | Description |
|---|---|---|
odds | Array<OutcomesResponse> | Array of outcome groups with calculated total odds. |
OutcomesResponse (item in response odds array):
| Property | Type | Description |
|---|---|---|
outcomes | Array<Outcome> | The outcomes this total odds value applies to. Do not mutate these objects. |
totalOdds | string | number | Calculated total odds for the combination. Use a string for display-formatted values. |
To keep the widget's selected-outcome state in sync with your own bet slip (i.e. show outcomes as selected when they were added outside the widget), use registerOnBetSlipChange inside registerAdapter.
// 1. Track your bet slip state
let changeCallback;
let betSlipState = { betslip: [], combinedOddsValue: undefined };
// 2. Notify the widget whenever the bet slip changes
function onBetSlipChanged(callback) {
changeCallback = callback;
changeCallback && changeCallback(betSlipState); // push current state immediately
}
// 3. Handle outcome clicks from the widget
function onItemClick(target, data) {
if (target === "externalOutcome") {
const newBet = {
externalEventId: data.externalEvent.id,
externalMarketId: data.externalMarket.id,
externalOutcomeId: data.externalOutcome.id,
externalSpecifierId: data.externalMarket.specifier
? data.externalMarket.specifier.value
: undefined,
};
betSlipState = {
betslip: [...betSlipState.betslip, newBet],
combinedOddsValue: "14.52", // replace with your own calculation
};
changeCallback && changeCallback(betSlipState);
}
}
// 4. Register adapter with bet slip sync + add the widget
SIR("registerAdapter", "{ADAPTER_NAME}", { onBetSlipChanged });
SIR("addWidget", "#sr-widget", "betRecommendation.markets", { onItemClick });Until a custom adapter is developed, use the mockData adapter for local testing:
SIR("registerAdapter", "mockData", { onBetSlipChanged });An adapter is a software component developed by the Sportradar engineering team that bridges the Bet Recommendation widgets and your platform's API. It retrieves data from your API and feeds it to the widget, ensuring seamless communication between the two systems.
Before adapter development begins, confirm and align your API contract with the Sportradar engineering team. Integration requires two SIR calls:
| SIR method | Purpose |
|---|---|
SIR('registerAdapter', ...) | Configure the adapter that retrieves and displays data from your API. |
SIR('addWidget', ...) | Mount the widget on the page. |
(function (a, b, c, d, e, f, g, h, i) {
a[e] ||
((i = a[e] =
function () {
(a[e].q = a[e].q || []).push(arguments);
}),
(i.l = 1 * new Date()),
(i.o = f),
(g = b.createElement(c)),
(h = b.getElementsByTagName(c)[0]),
(g.async = 1),
(g.src = d),
g.setAttribute("n", e),
h.parentNode.insertBefore(g, h));
})(
window,
document,
"script",
"https://widgets.sir.sportradar.com/sportradar/widgetloader",
"SIR",
{ language: "en" },
);
SIR("registerAdapter", "{ADAPTER_NAME}");
SIR("addWidget", "#sr-widget", "betRecommendation.markets");The following data types are provided by the adapter and are also available in the onItemClick callback payload.
Event
| Property | Type | Required | Description |
|---|---|---|---|
id | string | number | Yes | Sportradar event ID. |
externalId | string | number | — | Client-side event ID. |
date | string | Yes | Formatted date string displayed in the widget. |
sport.id | string | number | Yes | Sport ID. Use sportsMapping if not using Sportradar sport IDs. |
sport.name | string | Yes | Sport name. |
category.id | string | number | — | Category ID. |
category.name | string | Yes | Category name (e.g. "England"). |
tournament.id | string | number | — | Tournament/league ID. |
tournament.name | string | Yes | Tournament name. |
teams | Array<{id, name}> | Yes | Home and away competitors. |
isLive | boolean | Yes | Whether the event is currently live. |
liveCurrentTime | string | Yes | Live time display (e.g. "2nd set", "45'"). |
result1 / result2 / result3 | result | — | Score columns: { result: [homeScore, awayScore] }. |
Market
| Property | Type | Required | Description |
|---|---|---|---|
id | string | number | Yes | Market ID. |
name | string | — | Market name (e.g. "Match Winner"). |
status.isActive | boolean | — | When false, see Widget Behavior. |
Outcome
| Property | Type | Required | Description |
|---|---|---|---|
id | string | number | Yes | Outcome ID. |
name | string | Yes | Outcome name (e.g. "Home", "Draw"). |
odds | string | number | Yes | Odds value. Use a number type to enable odds-change indicators (up/down arrows). |
specifier.value |
betSlipMode is configured with multiple modes (e.g. ['multi', 'single']), only the first mode is active on mobile — tabs are not displayed in mobile mode.stringundefined |
Time/status filter option. Values: "live" (live events only), "not_started" (upcoming events only). When omitted, shows both live and upcoming events. |
time.range | number | undefined | Time range in hours for upcoming events. Range: 0-72 hours. Example: 24 shows events starting within next 24 hours. Only applicable when time.available is "not_started" or omitted. |
Basic swipe bet widget - button mode
JavaScript
SIR("addWidget", "#swipe-bet-1", "betRecommendation.swipeBet", {
productTitle: "SWIPE BET",
isMobile: false,
filters: {
sport: {
available: [1, 2, 5],
},
time: {
available: "not_started",
range: 24,
},
},
});HTML (data attributes)
<div
class="sr-widget"
data-sr-widget="betRecommendation.swipeBet"
data-product-title="SWIPE BET"
data-is-mobile="false"
data-filters='{"sport": {"available": [1, 2, 5]}, "time": {"range": 24}}'
></div>string | number |
| — |
Additional specifier (e.g. handicap value "-2.50"). |
status.isActive | boolean | — | When false, see Widget Behavior. |