getRecommendationsInit

Fetches the initial set of AI betting recommendations after access is confirmed. Returns multiple recommendation groups — individual single-bet suggestions (ORDINARY) and one express bet group (EXPRESS). Called once on login, right after has_access returns true.

Documentation

Try it now

Request parameters:

Name	Description	Type	Values	Default

source	Context source for recommendations.	string	"PREMATCH" / "LIVE"	-
betslip	Current betslip state to factor into recommendations	string	-	-
excludeGameIds	Game numeric IDs to exclude from the results	array	-	-
numRecommendations	How many recommendation groups to return	number	-	-

This method is usually used with these methods:

checkBettingMateAccess

Call example:
JavaScriptReact HookFlutter

getRecommendationsInit({
  source: 'PREMATCH'
})

Response examples:
SuccessError

{
  error: '',
  isLoading: false,
  data: {
    result: 0,
    details: {
      show: true,
      total_price: 18.1233593325,
      default_tab: 'ORDINARY',
      recommendations: [{
        type: 'ORDINARY',
        messages: ['Get locked in.'],
        recommendations: [{
          sport: 1,
          sport_alias: 'Football',
          region: 10001,
          region_alias: 'World',
          competition: 3042,
          competition_name: 'International Friendlies',
          game: 29935545,
          home_team_name: 'France',
          away_team_name: 'Northern Ireland',
          start_time: '2026-06-08T19:10:00Z',
          market: 2286503697,
          market_type: 'CornersOverUnder',
          tag: 106,
          selections: [6798305005, 6798305006],
          selection_prices: [1.71, 2.01],
          is_player_market: false,
          reason: null
        }]
      }, {
        type: 'EXPRESS',
        messages: ["Let's roll."],
        recommendations: []
      }]
    }
  }
}

Response parameters:

Name	Description	Type	Values

show	Whether the BettingMate UI should be shown	boolean	true / false
total_price	Combined odds of the express group	number	-
default_tab	Which tab to show by default ("ORDINARY" , "EXPRESS" or "EXPRESS_BUILDER")	string	-
recommendations	List of recommendation groups	array	-
└─		object
└─ type	"ORDINARY" — single match suggestion shown on the Single tab. "EXPRESS" — multi-leg express bet shown on the Multiple tab. One EXPRESS group per response, multiple ORDINARY groups.	string	-
└─ messages	AI-generated motivational taglines shown with the group (e.g. "Get locked in.")	array	-
└─		string	-
└─ recommendations	The actual game suggestions in this group	array	-
└─		object
└─ game	Swarm game ID	number	-
└─ sport	Sport ID	number	-
└─ sport_alias	Sport name	string	-
└─ region	Region ID	number	-
└─ region_alias	Region name	string	-
└─ competition	League ID	number	-
└─ competition_name	League name	string	-
└─ home_team_name	Home team name	string	-
└─ away_team_name	Away team name	string	-
└─ start_time	Match start time in ISO 8601 UTC	string	-
└─ market	Swarm market ID	number	-
└─ market_type	Market type key (e.g. "OverUnder", "CornersOverUnder")	string	-
└─ selections	Swarm selection IDs — ORDINARY groups may have 2 (both sides of a market), EXPRESS groups have 1 (the recommended side)	array	-
└─		number	-
└─ selection_prices	Odds for each selection	array	-
└─		number	-
└─ tag	Internal AI tag	number	-
└─ is_player_market	Whether this is a player-specific market	boolean	true / false
└─ reason	AI explanation for the pick (currently always null)	string	-