/
v3.0.11Get access

subscribeToLiveEventsWithSport

This API provides a comprehensive live subscription for a specific sport, delivering not just the match list, but detailed in-game data including live scores, period-by-period statistics, and current game state. It is used for "Live Sport" overview pages where users need a deep look at every match happening right now within a category like Water Polo or Soccer. Data structure sport -> region -> competition -> game

Request parameters:

NameDescriptionTypeValuesDefault
sportId
Targets the specific sport (e.g., ID 42)number--
sportAlias
Targets the specific sport (e.g., Alias 'WaterPolo')string--
marketTypes
Filters which betting markets to include directly inside the game object.array--
marketDisplayKeys
Filters which betting markets to include directly inside the game object.array["TOTALS", "WINNER", "Winner", "HANDICAP", "OUTRIGHT", "LAST" "GOAL", "FIRST" "GOAL", "CORRECT" "SCORE", "DOUBLE" "CHANCE", "HALFTIME"/"FULLTIME"]-
withoutOutright
A boolean to exclude "tournament winner" bets so the UI only shows actual 1v1 matches.booleantrue / false-
gameLimit
Caps the number of live games returned to prevent the UI from becoming overwhelmed.number--
isOlympicAvailable
Filter to include or exclude Olympic-specific event data.booleantrue / false-
isBetBuilderAvailable
If true, only returns matches that support builder bets.booleantrue / false-
isCloudAvailable
Internal flag for events with cloud-based featurebooleantrue / false-

Call example:

subscribeToLiveEventsWithSport({
  sportAlias: 'WaterPolo'
})

Response examples:

{
  sport: {
    '42': {
      id: 42,
      alias: 'WaterPolo',
      region: {
        '1900042': {
          id: 1900042,
          name: 'Russia',
          alias: 'Russia',
          order: 21,
          competition: {
            '4594': {
              id: 4594,
              name: 'Championship - Women',
              order: 21002,
              game: {
                '29757202': {
                  id: 29757202,
                  info: {
                    current_game_state: 'set2',
                    current_game_time: '06:20',
                    score1: '3',
                    score2: '1',
                    shirt1_color: '000000',
                    shirt2_color: '000000',
                    short1_color: '000000',
                    short2_color: '000000',
                    field: 0
                  },
                  stats: {
                    point: {
                      team1_value: 3,
                      team2_value: 1
                    },
                    passes: {
                      team1_value: null,
                      team2_value: null
                    },
                    score_set1: {
                      team1_value: 3,
                      team2_value: 1
                    },
                    score_set2: {
                      team1_value: 0,
                      team2_value: 0
                    }
                  },
                  is_live: 1,
                  team1_id: 294115,
                  team2_id: 17159,
                  start_ts: 1778599500,
                  _parent_id: 4594,
                  team2_name: 'Dynamo Uralochka (Wom)',
                  team1_name: 'Burevestnik-NNGU (Wom)',
                  is_blocked: 0,
                  sport_alias: 'WaterPolo',
                  region_alias: 'Russia',
                  markets_count: 0,
                  team2_reg_name: 'RU',
                  is_stat_available: false,
                  market: []
                },
                '29757206': {
                  id: 29757206,
                  info: {
                    current_game_state: 'set2',
                    current_game_time: '05:10',
                    score1: '5',
                    score2: '3',
                    shirt1_color: '000000',
                    shirt2_color: '000000',
                    short1_color: '000000',
                    short2_color: '000000',
                    field: 0
                  },
                  stats: {
                    point: {
                      team1_value: 5,
                      team2_value: 3
                    },
                    passes: {
                      team1_value: null,
                      team2_value: null
                    },
                    score_set1: {
                      team1_value: 2,
                      team2_value: 3
                    },
                    score_set2: {
                      team1_value: 3,
                      team2_value: 0
                    }
                  },
                  is_live: 1,
                  team1_id: 12252,
                  team2_id: 973769,
                  start_ts: 1778599200,
                  _parent_id: 4594,
                  team2_name: 'Eurasia (Wom)',
                  team1_name: 'KINEF Kirishi (Wom)',
                  is_blocked: 1,
                  sport_alias: 'WaterPolo',
                  region_alias: 'Russia',
                  markets_count: 0,
                  is_stat_available: false,
                  market: []
                }
              }
            }
          }
        }
      }
    }
  }
}