/
v3.0.11Get access

subscribeToEventsWithGame

This API creates a targeted subscription to monitor multiple specific matches simultaneously. Unlike other APIs that filter by a whole sport or league, this one allows you to provide a list of exact gameIds to watch—making it the ideal tool for a "My Bets" page or a "Favorites" dashboard where a user is tracking several unrelated matches at once.

Request parameters:

Name
DescriptionTypeValuesDefault
isGameOuterJoin
Allows to get game data even when no games match the filtersbooleantrue / false-
gameIds
An array of specific match numeric IDs to be tracked.array--
eventIds
An array of specific event numeric IDs to be tracked.array--
marketId
Allows you to narrow the focus further to specific market. number--
includeMarket
 A boolean that determines if the full market metadata (names, groups) should be included.booleantrue / false-
marketDisplayKeys
Tells the API to only send markets that fit a specific layout.string"TOTALS", "WINNER", "Winner", "HANDICAP", "OUTRIGHT", "LAST" "GOAL", "FIRST" "GOAL", "CORRECT" "SCORE", "DOUBLE" "CHANCE", "HALFTIME"/"FULLTIME"-
marketDisplaySubKey
Tells the API to only send sub markets that fit a specific layout.string"MATCH"-
marketTypeNames
Tells the API to only send market names that fit a specific layout.array--
marketTypes
Tells the API to only send market names that fit a specific layout.array--

Parameters marked with must be included in the request

Call example:

subscribeToEventsWithGame({
  gameIds: [29580938, 29635608, 29635610, 29638216]
})

Response examples:

{
  game: {
    '29580938': {
      sport: {
        type: 2
      },
      id: 29580938,
      show_type: 'OUTRIGHT',
      info: {
        current_game_state: 'notstarted',
        current_game_time: '0',
        add_minutes: '0',
        stoppage_firsthalf: '02:00',
        stoppage_secondhalf: '05:00',
        score1: '0',
        score2: '0',
        pass_team: 'none',
        shirt1_color: '000000',
        shirt2_color: '000000',
        short1_color: '000000',
        short2_color: '000000',
        field: 0
      },
      type: 2,
      stats: {
        passes: {
          team1_value: null,
          team2_value: null
        }
      },
      is_live: 0,
      team1_id: 644,
      team2_id: 774,
      start_ts: 1778698800,
      _parent_id: 572,
      team1_name: 'Lazio',
      team2_name: 'Inter Milan',
      is_blocked: 0,
      sport_alias: 'Soccer',
      exclude_ids: 0,
      sportcast_id: 528367,
      region_alias: 'Italy',
      markets_count: 477,
      is_stat_available: true,
      event: {
        '6648695666': {
          id: 6648695666,
          name: 'Over ',
          base: 2.5,
          type: 'Over',
          price: 2,
          order: 0,
          type_1: 'Over',
          type_id: 5448,
          original_order: 1,
          team_id: 548980,
          player_team_id: 548980
        }
      }
    },
    '29635608': {
      sport: {
        type: 2
      },
      id: 29635608,
      show_type: 'OUTRIGHT',
      info: {
        current_game_state: 'notstarted',
        current_game_time: '0',
        add_minutes: '0',
        stoppage_firsthalf: '02:00',
        stoppage_secondhalf: '05:00',
        score1: '0',
        score2: '0',
        pass_team: 'none',
        shirt1_color: '000000',
        shirt2_color: '000000',
        short1_color: '000000',
        short2_color: '000000',
        field: 0
      },
      type: 2,
      stats: {
        passes: {
          team1_value: null,
          team2_value: null
        }
      },
      is_live: 0,
      team1_id: 436,
      team2_id: 435,
      start_ts: 1778698800,
      _parent_id: 548,
      team1_name: 'Lens',
      team2_name: 'Paris Saint-Germain',
      is_blocked: 0,
      sport_alias: 'Soccer',
      exclude_ids: 0,
      sportcast_id: 471407,
      region_alias: 'France',
      markets_count: 548,
      is_stat_available: true,
      event: {
        '6709250040': {
          id: 6709250040,
          name: 'Over ',
          base: 3.5,
          type: 'Over',
          price: 2.13,
          order: 0,
          type_1: 'Over',
          type_id: 5448,
          original_order: 1,
          team_id: 548980,
          player_team_id: 548980
        }
      }
    },
    '29635610': {
      sport: {
        type: 2
      },
      id: 29635610,
      show_type: 'OUTRIGHT',
      info: {
        current_game_state: 'notstarted',
        current_game_time: '0',
        add_minutes: '0',
        stoppage_firsthalf: '02:00',
        stoppage_secondhalf: '05:00',
        score1: '0',
        score2: '0',
        pass_team: 'none',
        shirt1_color: '000000',
        shirt2_color: '000000',
        short1_color: '000000',
        short2_color: '000000',
        field: 0
      },
      type: 2,
      stats: {
        passes: {
          team1_value: null,
          team2_value: null
        }
      },
      is_live: 0,
      team1_id: 496,
      team2_id: 489,
      start_ts: 1778691600,
      _parent_id: 545,
      team1_name: 'Espanyol',
      team2_name: 'Athletic Bilbao',
      is_blocked: 0,
      sport_alias: 'Soccer',
      exclude_ids: 0,
      sportcast_id: 470627,
      region_alias: 'Spain',
      markets_count: 541,
      is_stat_available: true,
      event: {
        '6684494105': {
          id: 6684494105,
          name: 'Over ',
          base: 2.5,
          type: 'Over',
          price: 2.14,
          order: 0,
          type_1: 'Over',
          type_id: 5448,
          original_order: 1,
          team_id: 548980,
          player_team_id: 548980
        }
      }
    },
    '29638216': {
      sport: {
        type: 2
      },
      id: 29638216,
      show_type: 'OUTRIGHT',
      info: {
        current_game_state: 'notstarted',
        current_game_time: '0',
        add_minutes: '0',
        stoppage_firsthalf: '02:00',
        stoppage_secondhalf: '05:00',
        score1: '0',
        score2: '0',
        pass_team: 'none',
        shirt1_color: '000000',
        shirt2_color: '000000',
        short1_color: '000000',
        short2_color: '000000',
        field: 0
      },
      type: 2,
      stats: {
        passes: {
          team1_value: null,
          team2_value: null
        }
      },
      is_live: 0,
      team1_id: 395,
      team2_id: 931,
      start_ts: 1778698800,
      _parent_id: 538,
      team1_name: 'Manchester City',
      team2_name: 'Crystal Palace',
      is_blocked: 0,
      sport_alias: 'Soccer',
      exclude_ids: 0,
      sportcast_id: 470198,
      region_alias: 'England',
      markets_count: 574,
      is_stat_available: true,
      event: {
        '6684471618': {
          id: 6684471618,
          name: 'Over ',
          base: 3.5,
          type: 'Over',
          price: 1.81,
          order: 0,
          type_1: 'Over',
          type_id: 5448,
          original_order: 1,
          team_id: 548980,
          player_team_id: 548980
        }
      }
    }
  }
}