Complete API reference for the Bet Concierge widget with detailed parameter descriptions.

#API Reference

#onAction callback

Pass onAction function when you need to handle user events on bet concierge. The widget calls it with one argument: an object { type, data }.

• type — Which category of event occurred. Use this in a switch (or equivalent) as the first branch.
• data — Payload for that event. The shape depends on type.

#Action object

Each time the widget invokes your callback, it passes an object with the following fields:

#Action types

#CloseBetConcierge

Emitted when the user closes the widget from the header (X) button. Your integration should hide or unmount the widget (or navigate away), according to how you embedded it.

{
  source: "CloseSolution",
}

#WidgetError

Emitted when the widget reports an error (for example JWT failure). You can use error / details for logging.

Example payload:

{
  error: "401 Error when requesting https://sportradar.com/status",
  details: "Client token exception - Invalid token",
}

#AddSelectionsToBetSlip

Emitted when the user selects an outcome from AI-suggested markets (full integration with bet suggestion). Use the IDs to add the selection to your bet slip (or remove selection from bet slip - if selection is already in the bet slip).

Example payload:

{
  selections: [
    {
      type: "uf",
      event: "sr:match:123456",
      market: "1",
      outcome: "3",
      odds: {
        type: "eu",

#CustomBetAddToBetSlip

Emitted when 'Bet Combo' is enabled and the user adds a combo to the bet slip by clicking on 'Add to Betslip' button on the bet combo. Map selectedOutcomes into your bet slip.

displayedOdds is a snapshot only — re-validate and re-price before placement. See Handling Selections and Odds.

Example payload:

{
  entityId: "sr:match:61623782",
  displayedOdds: "2.95",
  selectedOutcomes: [
    {
      marketId: "1",
      outcomeId: "1",
      marketName: "1x2",
      marketSpecifier: undefined,
      outcomeName: "Ceuta",
    },
    {
      marketId: "18"

#Example: handle all action types

onAction: function (action) {
  const { type, data } = action;
  switch (type) {
    case "Close": {
      if (data.source === "CloseSolution") {
        // Hide or destroy the widget container (header close).
      }
      break;

#getJwt()

Defines the structure of a callback promise function that retrieves a JWT token for user authentication. This function gets called when the Bet Concierge widget is initialized and when token refresh is needed.

// Example implementation of getJwt function:
function getJwt() {
  return fetch("https://example.com/api/get-jwt/user123")
    .then((response) => response.json())
    .then((data) => data.token); // Must resolve to the JWT string - assuming backend returns { "token": "..." }
}

#Widget Integration

This guide provides step-by-step instructions for integrating the Sportradar Bet Concierge widget into your website. It includes details about the required components, such as an adapter developed by Sportradar's engineering team, and options for custom theming. Following these instructions will help ensure a seamless integration and an improved user experience.

#Prerequisites

Before starting, ensure you have:

See Getting Identifiers for information on obtaining match IDs and authentication tokens.

#Integration Examples

The Bet Concierge widget can be integrated into your website using JavaScript. There are three levels of integration, each offering different features and requiring varying levels of development effort:

#Next Steps

Now that you have integration working, check Theming customization for custom styling.

This is the simplest option and requires minimal development effort. It includes an interactive AI chat widget that can answer all stats-related queries.

Properties do not always transfer from the above table directly into integration code. Properties must be transformed differently for each integration method:

JavaScript/Programmatic Integration

• Property names remain unchanged in camelCase
• Properties become members of the 4th parameter object in SIR() call
• Example: cardVariant: "compact"

HTML/Declarative Integration

• Convert camelCase to lowercase with dashes, e.g. cardVariant becomes card-variant
• Add data-sr- prefix
• Example: cardVariant → data-sr-card-variant
• Example: filters.sport.hidden → Complex objects must be passed as JSON strings

Step 1: Add Widgetloader

Add the widgetloader script to your HTML page:

Replace sportradar in the widgetloader URL path with your clientId, ENTITY_ID with Sportradar entity identifier in sr:match:{id} format (e.g., "sr:match:50955863"), and JWT with your JSON Web Token.

The example above uses a static jwt string for brevity. In production, use a getJwt callback so the token can be refreshed without reloading the widget — see Dynamic JWT Function below.

Dynamic JWT Function

Step 2: Create a Widget Container

Add a container element where the widget will be displayed:

That's it! The Bet Concierge widget is now live on your page.