/
v3.0.11Get access

subscribeToAnnualGamesOnly

This API establishes a real-time subscription to a filtered stream of sporting events that occur on an annual or recurring seasonal basis. Unlike standard live or prematch subscriptions, this method is optimized to track specific competition cycles or long-term tournament schedules. It ensures the client receives immediate updates on game status, odds, and availability for high-level filtered categories (Team, Sport, or Competition).

Request parameters:

Name
DescriptionTypeValuesDefault
isGameOuterJoin
Allows to get game data even when no games match the filtersbooleantrue / false-
sportId
The unique identifier for the sport category (e.g., Soccer = 1, Tennis = 2).number--
regionId
The ID of the region within the selected sportnumber--
competitionId
The unique ID for a specific league or tournament (e.g., Premier League, Champions League). Used to subscribe to an entire seasonal bracket.number--
teamId
The unique identifier for a specific sports team. Filters the subscription to only return games where this team is a participant.number--
isCloudAvailable
A filter to include only games that support cloud-based broadcasting or advanced data streaming servicesbooleantrue / false-
isBetBuilderAvailable
A toggle to filter the subscription for games that support the Bet Builder feature (allowing users to combine multiple markets from the same game into a single wager)booleantrue / false-

Parameters marked with must be included in the request

Call example:

subscribeToAnnualGamesOnly({
  sportId: 1,
  regionId: 3,
  teamId: 7890,
  competitionId: 456
})

Response examples:

{
  game: {
    '29385643': {
      id: 29385643,
      is_live: 0,
      start_ts: 1776279600,
      team1_id: 387,
      team2_id: 664,
      team2_name: 'Sporting CP',
      team1_name: 'Arsenal',
      sport_alias: 'Soccer',
      region_alias: 'Europe',
      add_info_name: 'Quartas de final. Placar do jogo de ida'
    },
    '29385644': {
      id: 29385644,
      is_live: 0,
      start_ts: 1776279600,
      team1_id: 457,
      team2_id: 516,
      team2_name: 'Real Madrid',
      team1_name: 'Bayern Munich',
      sport_alias: 'Soccer',
      region_alias: 'Europe',
      add_info_name: 'Quartas de final. Placar do jogo de ida'
    }
  }
}