/
v3.0.11Get access

subscribeToEventsWithSport

This API function establishes a highly targeted, real-time data subscription for a specific sports or esports match. It allows the client to listen for instant updates (such as score changes, clock adjustments, or odds fluctuations) by filtering down through the entire sports data hierarchy using explicit identifiers and aliases.

Request parameters:

Name
DescriptionTypeValuesDefault
gameId
Pinpoints the specific match.number--
sportId
Identifies the broad sports category by idnumber--
eventId
Targets a specific sub-event outcome within the game if tracking granular occurrences.number--
regionId
Filters by the geographical region or continent of the tournament id.number--
marketId
Isolates a specific betting market line.number--
sportAlias
Identifies the broad sports category by alias.string--
regionAlias
Filters by the geographical region or continent of the tournament alias.string--
competitionId
Targets the specific tournament, league, or cup.number--
isCloudAvailable
Filters for sports with cloud-streaming support.booleantrue / false-
isBetBuilderAvailable
Feature toggles that instruct the stream to include or exclude complex same-game-parlay (Bet Builder) pricing configurations and data structures.booleantrue / false-
isInternalBetBuilderAvailable
Feature toggles that instruct the stream to include or exclude complex same-game-parlay (Internal Bet Builder) pricing configurations and data structures.booleantrue / false-

Call example:

subscribeToEventsWithSport({
  competitionId: 16758,
  gameId: 29855462,
  isCloudAvailable: false,
  regionAlias: 'Ethiopia',
  sportAlias: 'Soccer'
})

Response examples:

{
  sport: {
    '1': {
      id: 1,
      name: 'Football',
      alias: 'Soccer',
      order: 1,
      region: {
        '780001': {
          id: 780001,
          name: 'Ethiopia',
          alias: 'Ethiopia',
          competition: {
            '16758': {
              id: 16758,
              name: 'Premier League',
              order: 1,
              game: {
                '29855462': {
                  id: 29855462,
                  info: {
                    current_game_state: 'set2',
                    current_game_time: '50',
                    add_minutes: '0',
                    stoppage_firsthalf: '03:00',
                    stoppage_secondhalf: '05:00',
                    score1: '0',
                    score2: '0',
                    pass_team: 'none',
                    shirt1_color: 'F8E71C',
                    shirt2_color: '000000',
                    short1_color: '000000',
                    short2_color: '000000',
                    field: 0
                  },
                  type: 1,
                  stats: {
                    shot_on_target: {
                      team1_value: 1,
                      team2_value: 3
                    },
                    throw_in: {
                      team1_value: 15,
                      team2_value: 16
                    },
                    attack: {
                      team1_value: 87,
                      team2_value: 130
                    }
                  },
                  is_live: 1,
                  team1_id: 264850,
                  team2_id: 264050,
                  start_ts: 1779969600,
                  text_info: '0 : 0, (0:0), (0:0) 50`',
                  is_blocked: 0,
                  team1_name: 'Hawassa City',
                  team2_name: 'Ethiopia Bunna SC',
                  live_events: [{
                    time_utc: '5/28/2026 4:06:01 PM +04:00',
                    time: 1779969961,
                    current_minute: "5'",
                    type_id: '3',
                    side: '1',
                    period_sequence: 1,
                    event_value: 1
                  }, {
                    time_utc: '5/28/2026 4:11:40 PM +04:00',
                    time: 1779970300,
                    current_minute: "11'",
                    type_id: '2',
                    side: '1',
                    period_sequence: 1,
                    event_value: 1
                  }],
                  match_length: '90',
                  is_stat_available: true,
                  market: {
                    '2275435148': {
                      id: 2275435148,
                      name: 'Both Teams To Score',
                      type: 'BothTeamsToScore',
                      order: 2000000,
                      cashout: 1,
                      sequence: 0,
                      col_count: 2,
                      group_name: 'Match',
                      express_id: 1,
                      group_id: 1,
                      group_order: 2,
                      market_type: 'BothTeamsToScore',
                      point_sequence: 0,
                      prematch_express_id: 1,
                      available_for_betbuilder: true,
                      event: {
                        '6767520470': {
                          id: 6767520470,
                          type: 'Yes',
                          name: 'Yes',
                          price: 6.7,
                          order: 0,
                          type_1: 'Yes',
                          type_id: 6549
                        },
                        '6767520471': {
                          id: 6767520471,
                          type: 'No',
                          name: 'No',
                          price: 1.06,
                          order: 1,
                          type_1: 'No',
                          type_id: 6550
                        }
                      }
                    },
                    '2275435164': {
                      id: 2275435164,
                      name: 'Double Chance',
                      type: '1X12X2',
                      order: 1200000,
                      cashout: 1,
                      sequence: 0,
                      col_count: 3,
                      group_name: 'Match',
                      express_id: 1,
                      group_order: 2,
                      market_type: 'DoubleChance',
                      point_sequence: 0,
                      prematch_express_id: 1,
                      available_for_betbuilder: true,
                      event: {
                        '6767520580': {
                          id: 6767520580,
                          type: '1X',
                          name: '1X',
                          price: 1.7,
                          order: 0,
                          type_1: '1X',
                          type_id: 6540
                        },
                        '6767520581': {
                          id: 6767520581,
                          type: '12',
                          name: '12',
                          price: 1.67,
                          order: 1,
                          type_1: '12',
                          type_id: 6541
                        },
                        '6767520582': {
                          id: 6767520582,
                          type: 'X2',
                          name: 'X2',
                          price: 1.06,
                          order: 2,
                          type_1: 'X2',
                          type_id: 6542
                        }
                      },
                      componentName: 'WithBaseColumns'
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}