/
v3.0.11Get access

subscribeToUpcomingGamesOnly

This API function establishes a real-time subscription focused exclusively on upcoming, scheduled fixtures, filtering out any games that are currently live or in-play. It allows the client application to listen for schedule changes, participant updates, and opening pre-match odds while using strict time bounds and volume limits to optimize data delivery.

Request parameters:

Name
DescriptionTypeValuesDefault
limit
An integer that caps the total number of upcoming matches returned in the data payload.number--
lessThan
A timestamp that defines the upper time ceiling for the query.number--
sportAlias
Filters the upcoming stream to a single, specific sport alias.string--
isCloudAvailable
Filters for sports with cloud-streaming support.booleantrue / false-
isOlympicAvailable
A toggle to explicitly include or exclude upcoming tournament fixtures tied to Olympic events.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-

Parameters marked with must be included in the request

Call example:

subscribeToUpcomingGamesOnly({
  lessThan: 1779989705,
  limit: 5,
  sportAlias: 'Soccer'
})

Response examples:

{
  game: {
    '29891548': {
      region: {
        name: 'Dinamarca',
        order: 171
      },
      competition: {
        name: 'Danmarksserien',
        order: 192006,
        cloud_available: false
      },
      id: 29891548,
      team1_id: 15184,
      team2_id: 193058,
      start_ts: 1779989400,
      _parent_id: 9228,
      team2_name: 'Fuglebakken KFUM Arhus',
      team1_name: 'Hedensted IF',
      sport_alias: 'Soccer',
      region_alias: 'Denmark',
      team1_reg_name: 'DK',
      team2_reg_name: 'DK'
    },
    '29892190': {
      region: {
        name: 'Finlândia',
        order: 187
      },
      competition: {
        name: 'Kolmonen',
        order: 203008,
        cloud_available: false
      },
      id: 29892190,
      team1_id: 1372831,
      team2_id: 1388214,
      start_ts: 1779984000,
      _parent_id: 11136,
      team2_name: 'FC Vaajakoski 2',
      team1_name: 'FC Metso',
      sport_alias: 'Soccer',
      region_alias: 'Finland'
    },
    '29892926': {
      region: {
        name: 'Finlândia',
        order: 187
      },
      competition: {
        name: 'Kolmonen',
        order: 203008,
        cloud_available: false
      },
      id: 29892926,
      team1_id: 286,
      team2_id: 97992,
      start_ts: 1779984000,
      _parent_id: 11136,
      team2_name: 'Lapuan Virkia',
      team1_name: 'FC Ylivieska',
      sport_alias: 'Soccer',
      region_alias: 'Finland',
      team1_reg_name: 'FI',
      team2_reg_name: 'FI'
    },
    '29896318': {
      region: {
        name: 'Finlândia',
        order: 187
      },
      competition: {
        name: 'Kolmonen',
        order: 203008,
        cloud_available: false
      },
      id: 29896318,
      team1_id: 27916,
      team2_id: 669648,
      start_ts: 1779982200,
      _parent_id: 11136,
      team2_name: 'KJP Kouvola',
      team1_name: 'Kultsu FC',
      sport_alias: 'Soccer',
      region_alias: 'Finland',
      team1_reg_name: 'FI',
      team2_reg_name: 'FI'
    },
    '29896319': {
      region: {
        name: 'Finlândia',
        order: 187
      },
      competition: {
        name: 'Kolmonen',
        order: 203008,
        cloud_available: false
      },
      id: 29896319,
      team1_id: 97274,
      team2_id: 224954,
      start_ts: 1779983100,
      _parent_id: 11136,
      team2_name: 'HaPK Haminan',
      team1_name: 'Mikkelin Pallo Kissat',
      sport_alias: 'Soccer',
      region_alias: 'Finland',
      team1_reg_name: 'FI',
      team2_reg_name: 'FI'
    }
  }
}