--- title: "My Combo" canonical_url: "https://apidocs.sportradar.com/resources/widgets/docs/bet-recommendation/my-combo" markdown_url: "https://apidocs.sportradar.com/resources/widgets/docs/bet-recommendation/my-combo.md" last_updated: "2026-08-11T13:11:13Z" --- # My Combo **My Combo** widget is a front-end widget that provides a **personalized betting experience** and a simplified way to discover and place multi bets. The main feature of the widget is the user interface that allows punters to quickly add multi bet combinations to the bet slip, find new ones or create their own on the fly. - Punters past activity - General betting trends - Overall betting volume - Seasonal variations - New discovery and engagement patterns > **Info** > > **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. ## Key Capabilities ### Simple Interface Intuitive UI that simplifies the discovery and placement of multi-leg accumulators. ### AI Personalization Tailors the most popular multi-bet combinations to each punter's personal preferences. ### Discovery Engine Surface high-engagement betting opportunities that users might have otherwise missed. ### Live & Pre-match Full support for real-time in-play accumulators and upcoming pre-match event bundles. ### Seamless Integration Rapid client-side setup with minimal configuration needed for basic deployment. ### Full Customization Extensive styling and configuration options to ensure the widget feels native to your brand. ## UI and Interaction Options ### Flexible Layouts Switch between focused single-card views or high-density horizontal carousels. ### Instant Bet Slip One-click integration to add entire multi-leg combos directly to the operator's bet slip. ### Smart Discovery Users can "Load New Combo" or refresh individual legs to find the perfect bet on the fly. ### Interactive Editing Optional support for adding or removing legs directly within the combo card interface. ## Settings and Customization - Version: mixed match multi bets or same match multi bets (same match depends on API readiness) - Recommendation type: recommended (default) or popular (when user ID is not available) - Sport filter - Time span: live, pre-match, or hours until kickoff - Widget name - Add/remove legs toggle - Load new combo button - Load different leg button (not compatible with add/remove legs) - Ticket length: maximum ticket length (default 4, minimum 2) - Maximum combined odds threshold - Mobile/desktop mode ## Styling Options - Elements (container, cards, buttons): colors, rounded corners, icons - Text: font styles and colors ## Requirements - 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: - **widget-name**: `betRecommendation.myCombo` **Environment Requirements** ## Technical Requirements: - JavaScript enabled - XMLHttpRequest support for data fetching - CSS3 support for styling and animations **Supported Sports** ## Main Configurable Features See the [My Combo widget demo](https://widgets.sir.sportradar.com/bet-recommendation#widget:\(name:betRecommendation.myCombo\)). Illustrations of main layout variants and bet types with relevant property values below. **Single Card Layout** ![Single Card Layout](https://apidocs.sportradar.com/resources/widgets/static/img/mycombo/layoutSingle.png) Single combo card showing multi-leg accumulator with combined odds and add to bet slip button. **Carousel Layout** ![Carousel Layout](https://apidocs.sportradar.com/resources/widgets/static/img/mycombo/layoutCarousel.png) Multiple combo cards in horizontal carousel with navigation arrows for browsing options. **Combo Card Details** ![Combo Card Details](https://apidocs.sportradar.com/resources/widgets/static/img/mycombo/layoutSingle.png) Detailed combo card showing team names, markets, outcomes, individual odds, and total odds. ## API Reference ### Basic Properties | Property | Type | Default | Description | | -------------------- | ---------------- | ------------ | -------------------------------------------------------------- | | `user` | `string\|number` | `0` | User identifier for personalized combo recommendations. | | `productTitle` | `string` | `undefined` | Title text displayed in widget header. | | `showHeader` | `boolean` | `true` | Controls visibility of widget header. | | `showRefreshButton` | `boolean` | `false` | Enables refresh functionality for new combos. | | `numberOfCards` | `number` | `10` | Number of combo cards for carousel layout (2-20). | | `layout` | `string` | **Required** | Display mode: `"single"` or `"carousel"`. | | `editLegAction` | `string` | `undefined` | Enables leg editing: `"replace"` or `undefined`. | | `betType` | `string` | `"mixed"` | Combo type: `"mixed"` (cross-event) or `"same"` (bet builder). | | `minTicketLength` | `number` | `3` | Minimum number of legs per combo (2-12). | | `maxTicketLength` | `number` | `4` | Maximum number of legs per combo (2-12). | | `maxAllowedOdds` | `number` | `undefined` | Maximum allowed combined odds. | | `minRequiredLegOdds` | `number` | `undefined` | Minimum required combined odds. | | `eventId` | `string\|number` | `undefined` | Event identifier (required when `betType: "same"`). | | `onItemClick` | `function` | `undefined` | Callback for combo card interactions. | | `debug` | `boolean` | `false` | Enables debug mode with console logging. | **Extended Properties** | Property | Type | Default | Description | | --------------- | --------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `buttonIcon` | `string\|false` | `undefined` | Custom icon URL for "Add to Bet Slip" button on combo cards. When provided, displays custom icon alongside button text. When `false`, hides icon entirely (text-only button). When `undefined`, uses default plus icon. | | `filters` | `object` | **Required** | Configuration object for sport and league filters. See below for detailed structure. | | `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. Allows using client's sport taxonomy in filter configurations. | ### Filters Object The `filters` object controls which sports and leagues generate combo recommendations. | Property | Type | Default | Description | | ------------------ | ----------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `sport` | `object` | **Required** | Sport filter configuration. | | `sport.available` | `array` | `[]` | **Required.** Array of Sportradar sport IDs to include in combo generation. Empty array shows all available sports. Example: `[1, 2, 5]` for soccer, basketball, tennis. AI generates combos using events from specified sports only. See [Sports Reference](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/references/sports.md). | | `league` | `object` | `undefined` | League/tournament filter configuration. | | `league.available` | `array` | `undefined` | Array of Sportradar tournament/league IDs to include in combo generation. When provided, AI generates combos using only events from specified leagues. Example: `["sr:tournament:17", "sr:tournament:7"]` for Premier League and La Liga. See [Getting Identifiers](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/getting-identifiers.md). | #### Filters Example ```javascript { sport: { available: [1, 2, 5] // Soccer, Basketball, Tennis }, league: { available: [ "sr:tournament:17", // Premier League "sr:tournament:34", // Bundesliga "sr:tournament:132" // NBA ] } } ``` ## Theming 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-br-mycombo` 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-card` | `background-color`, `color`, `border-radius` | | `srct-br-header` | `background-color`, `color`, `border-radius`, `font-style` | | `srct-br-card__divider` | `border-color` | | `srct-br-eventinfo__icon` | `color` | | `srct-br-eventinfo__status` | `font-size`, `color` | | `srct-br-eventinfo__name` | `font-size`, `color` | | `srct-br-eventinfo__time` | `font-size`, `color` | | `srct-br-marketselectionbutton-outcometeamname` | `font-style`, `font-size`, `color` | | `srct-br-outcome__value` | `font-style`, `font-size`, `color` | | `srct-br-outcome__name` | `font-style`, `font-size`, `color` | | `srct-br-scoreboard` | `font-size`, `color` | | `srct-br-scoreboard__teams` | `font-size`, `color` | | `srct-br-scoreboard__datetime` | `font-size`, `color` | | `srct-br-footer` | `font-size`, `font-style`, `color`, `background-color`, `border-radius` | | `srct-br-widgetbutton` | `font-size`, `font-style`, `color`, `border-radius`, `padding`, `background-color` | | `srct-br-widgetbutton__icon` | `color`, `height`, `width` | ## Integration > **Warning** > > **Mandatory Configuration** > The `filters` property is required for this widget to function correctly. It defines the recommendation logic and basic data constraints. ![Bet Recommendation technical guide](https://apidocs.sportradar.com/resources/widgets/static/img/betRecommendationTechnicalGuide.jpg) Demo: [Open demo](https://widgets.sir.sportradar.com/bet-recommendation#widget:\(name:betRecommendation.myCombo\)) ### Widget Setup **Single Combo** Basic single combo card with mixed events for anonymous users. **JavaScript** ```javascript SIR("addWidget", "#my-combo-1", "betRecommendation.myCombo", { layout: "single", betType: "mixed", filters: { sport: { available: [1, 2], }, }, }); ``` **HTML (data attributes)** ```html
``` **Carousel Layout** Carousel layout with multiple combo options and 3-5 legs per ticket. **JavaScript** ```javascript SIR("addWidget", "#my-combo-2", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 10, minTicketLength: 3, maxTicketLength: 5, filters: { sport: { available: [1, 2, 5], }, }, }); ``` **HTML (data attributes)** ```html
``` **Bet Builder** Same-event bet builder with multiple markets from a single match. **JavaScript** ```javascript SIR("addWidget", "#my-combo-3", "betRecommendation.myCombo", { layout: "single", betType: "same", eventId: "67681902", minTicketLength: 3, maxTicketLength: 4, productTitle: "BET BUILDER", filters: { sport: { available: [1], }, }, }); ``` **HTML (data attributes)** ```html
``` **Personalized** > **Info** > > **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. Personalized combo picks for logged-in users based on history. **JavaScript** ```javascript SIR("addWidget", "#my-combo-4", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", user: "user123", numberOfCards: 8, productTitle: "YOUR COMBO PICKS", filters: { sport: { available: [1, 2, 5, 23], }, }, }); ``` **HTML (data attributes)** ```html
``` **Odds Range** Combo recommendations controlled by minimum and maximum odds ranges. **JavaScript** ```javascript SIR("addWidget", "#my-combo-5", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 10, minTicketLength: 3, maxTicketLength: 4, minRequiredLegOdds: 5, // Minimum 5.0 combined odds maxAllowedOdds: 50, // Maximum 50.0 combined odds filters: { sport: { available: [1], }, }, }); ``` **HTML (data attributes)** ```html
``` **Refreshable** Daily combos with a refresh button for quick discovery of new options. **JavaScript** ```javascript SIR("addWidget", "#my-combo-6", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 5, showRefreshButton: true, productTitle: "DAILY COMBOS", filters: { sport: { available: [1, 2], }, }, }); ``` **HTML (data attributes)** ```html
``` **League Specific** Combos generated exclusively from top soccer leagues. **JavaScript** ```javascript SIR("addWidget", "#my-combo-7", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 8, productTitle: "TOP LEAGUES COMBOS", filters: { sport: { available: [1], }, league: { available: [ "sr:tournament:17", // Premier League "sr:tournament:34", // Bundesliga "sr:tournament:7", // La Liga ], }, }, }); ``` **HTML (data attributes)** ```html
``` **Editable Legs** Custom combo configuration allowing users to replace individual legs. **JavaScript** ```javascript SIR("addWidget", "#my-combo-8", "betRecommendation.myCombo", { layout: "single", betType: "mixed", minTicketLength: 4, maxTicketLength: 6, editLegAction: "replace", productTitle: "CUSTOM COMBO", filters: { sport: { available: [1, 2], }, }, }); ``` **HTML (data attributes)** ```html
``` **Click Handler** Full interaction handling with event tracking for additions and refreshes. **JavaScript** ```javascript SIR("addWidget", "#my-combo-9", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 10, onItemClick: function (target, data) { console.log("My Combo interaction:", target, data); if (target === "addToBetSlip") { // User clicked add to bet slip button const selections = data.selections; const combinedOdds = data.combinedOdds; // Add entire combo to bet slip addComboToBetSlip(selections, combinedOdds); // Track analytics gtag("event", "combo_added", { leg_count: selections.length, combined_odds: combinedOdds, sport_ids: selections.map((s) => s.sportId), }); } else if (target === "refresh") { // User clicked refresh button gtag("event", "combo_refreshed", { card_index: data.cardIndex, }); } else if (target === "leg") { // User clicked individual leg (if clickable) gtag("event", "combo_leg_click", { event_id: data.selection.eventId, market: data.selection.marketName, }); } }, filters: { sport: { available: [1, 2, 5], }, }, }); ``` **Branded** Custom branded widget with unique title and button icons. **JavaScript** ```javascript SIR("addWidget", "#my-combo-10", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 10, productTitle: "ACCA OF THE DAY", buttonIcon: "https://example.com/icons/add-combo.svg", showHeader: true, filters: { sport: { available: [1], }, }, }); ``` **High Value** Focus on high-value combos with minimum 8.0 combined odds. **JavaScript** ```javascript SIR("addWidget", "#my-combo-11", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 5, minTicketLength: 3, maxTicketLength: 5, minRequiredLegOdds: 8, productTitle: "HIGH VALUE COMBOS", filters: { sport: { available: [1, 2], }, }, }); ``` **HTML (data attributes)** ```html
``` **Advanced** Advanced configuration with custom sport ID mapping and safe odds caps. **JavaScript** ```javascript SIR("addWidget", "#my-combo-13", "betRecommendation.myCombo", { layout: "carousel", betType: "mixed", numberOfCards: 8, sportsMapping: { 101: 1, // Client sport 101 = Soccer 102: 2, // Client sport 102 = Basketball 105: 5, // Client sport 105 = Tennis }, filters: { sport: { available: [101, 102, 105], }, }, }); ``` ### onItemClick 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"` | ```javascript SIR("addWidget", "#sr-widget", "betRecommendation.markets", { onItemClick: function (target, data) { if (target === "externalOutcome") { // Add single outcome to bet slip const { externalEvent, externalMarket, externalOutcome } = data; betSlip.add({ eventId: externalEvent.id, marketId: externalMarket.id, outcomeId: externalOutcome.id, }); } else if (target === "externalEvent") { // Navigate to event/match detail page window.location.href = `/matches/${data.externalEvent.id}`; } else if (target === "externalCompetition") { // Navigate to competition/league page window.location.href = `/league/${data.externalCompetition.tournament.id}`; } }, filters: { recommendationType: { available: "popular" } }, }); ``` For the full flow after a selection is emitted — trusting snapshot odds, re-pricing against your platform, validating availability, and accepting or rejecting the bet — see [Handling Selections and Odds](https://apidocs.sportradar.com/resources/widgets/docs/tutorials/handling-selections-and-odds.md). 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](https://apidocs.sportradar.online/resources/widgets/docs/tutorials/tracking-guide) for details. ### Total Odds Sync 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: ```javascript 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` | 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` | Array of outcome groups with calculated total odds. | **OutcomesResponse** (item in response `odds` array): | Property | Type | Description | | :---------- | :----------------- | :------------------------------------------------------------------------------------ | | `outcomes` | `Array` | 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. | ### Bet Slip Sync 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`. ```javascript // 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: ```javascript SIR("registerAdapter", "mockData", { onBetSlipChanged }); ``` ### Adapter Setup 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. SIR Widgets supports two types of adapter implementations: 1. [Self-Service Adapter](https://apidocs.sportradar.com/resources/widgets/docs/adapter/SelfServiceImplementation.md) 2. [Hosted Adapter](https://apidocs.sportradar.com/resources/widgets/docs/adapter/HostedImplementation.md) 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. | ```javascript (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"); ``` #### Adapter Endpoint Requirements ##### Mandatory Endpoints - `eventMarkets` or (`market` + `availableMarketsForEvent`) - `event` ##### Optional Endpoints - `betSlipSelection` - visual representation of markets already in betslip #### Adapter Implementation Template This is an example of an adapter implementing all endpoints. It is intended to be a copy/paste template, where only data fetching and transformation need to be implemented. When implementing an adapter, implement only the endpoints which are required by the widget being integrated, and discard the rest. For each endpoint, only the `getData${ENDPOINT_NAME}()` and `transormData${ENDPOINT_NAME}()` functions need to be implemented. ***Expand Adapter Template Code*** ```html ``` ### Data Types 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](#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` | `string \| number` | — | Additional specifier (e.g. handicap value `"-2.50"`). | | `status.isActive` | `boolean` | — | When `false`, see [Widget Behavior](#widget-behavior). | ## Tips - When `maxAllowedOdds` is exceeded, the widget trims legs starting from the highest-odds one and recalculates; this repeats until combined odds fall below the limit or the card drops below `minTicketLength`, in which case the card is discarded. - Setting a high `minRequiredLegOdds` combined with a low `maxTicketLength` can result in no cards being returned. Use `debug: true` to inspect how thresholds are filtering combos. - With `editLegAction: "replace"`, the replacement leg is constrained to the same sport, a similar odds range, and compatibility with the remaining legs.