/
v3.0.11Get access

subscribeToUpcomingEventsWithSport

This API is the "Heavy Pre-match" version of your data subscriptions. It doesn't just show upcoming games; it includes the primary betting markets (like Match Result) and their live odds directly in the response. It is used to build the main "Sports Betting Lobby" where users see a list of future games and can place a quick bet without clicking into the match. Data structure sport -> region -> competition -> game

Request parameters:

Name
DescriptionTypeValuesDefault
to
Defines the specific time window start (Unix timestamps) for the games.number--
from
Defines the specific time window end (Unix timestamps) for the games.number--
hours
The look-ahead window (e.g., 2 for events starting within 2 hours).number--
timePeriod
A predefined duration category.string"all", "future", "today", "tomorrow"-
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"]-
limit
Restricts the number of games per page to ensure the UI stays fast.number--
isLive
Usually set to false for this call, as it focuses on upcoming (pre-match) events.booleantrue / false-
sportAlias
Targets the specific sport (e.g., Alias 'WaterPolo')string--
isOlympicAvailable
Filter to include or exclude Olympic-specific event data.booleantrue / false-
isBetBuilderAvailable
If true, only returns matches that support builder betsbooleantrue / false-
isCloudAvailable
Internal flag for events with cloud-based featurebooleantrue / false-
isGameOuterJoin
Allows to get game data even when no games match the filtersbooleantrue / false-

Parameters marked with must be included in the request

Call example:

subscribeToUpcomingEventsWithSport({
  sportAlias: 'Soccer',
  marketDisplayKeys: 'FIRST GOAL'
})

Response examples:

{
  sport: {
    '42': {
      id: 42,
      alias: 'WaterPolo',
      region: {
        '20042': {
          id: 20042,
          name: 'Europe',
          alias: 'Europe',
          order: 12,
          competition: {
            '1070': {
              id: 1070,
              name: 'Champions League',
              order: 2002,
              game: {
                '29713433': {
                  id: 29713433,
                  info: {
                    current_game_state: 'notstarted',
                    current_game_time: '08:00',
                    score1: '0',
                    score2: '0',
                    shirt1_color: '000000',
                    shirt2_color: '000000',
                    short1_color: '000000',
                    short2_color: '000000',
                    field: 0
                  },
                  stats: {
                    passes: {
                      team1_value: null,
                      team2_value: null
                    }
                  },
                  is_live: 0,
                  start_ts: 1778610600,
                  team1_id: 5545,
                  team2_id: 5548,
                  _parent_id: 1070,
                  is_blocked: 0,
                  team1_name: 'HAVK Mladost',
                  team2_name: 'Pro Recco',
                  sport_alias: 'WaterPolo',
                  region_alias: 'Europe',
                  markets_count: 26,
                  favorite_order: null,
                  is_stat_available: true,
                  market: {
                    '2251053989': {
                      id: 2251053989,
                      type: 'P1XP2',
                      name: 'Match Result',
                      order: 400000,
                      cashout: 1,
                      sequence: 0,
                      col_count: 3,
                      group_name: 'Match',
                      market_type: 'MatchResult',
                      group_order: 1,
                      point_sequence: 0,
                      event: {
                        '6697850389': {
                          id: 6697850389,
                          price: 6,
                          name: 'W1',
                          order: 0
                        },
                        '6697850391': {
                          id: 6697850391,
                          price: 1.19,
                          name: 'W2',
                          order: 2
                        },
                        '6697850390': {
                          id: 6697850390,
                          price: 9.7,
                          name: 'X',
                          order: 1
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}