addRefreshRecommendations

Fetches a refreshed set of AI-recommended games for an express bet. Used when the user wants to swap out a specific game, add a new leg, or completely regenerate the express list.

This command requires the logged in session

Documentation

Try it now

Request parameters:

Name	Description	Type	Values	Default

gameIds	IDs of the games to keep in the express. The AI anchors new suggestions around these.	array	-	-
excludeGameIds	IDs to exclude from the result — usually the game being swapped out so the AI doesn't return it again.	array	-	-
newGamesCount	How many new games to add/replace.	string	-	1

Call example:
JavaScriptReact HookFlutter

addRefreshRecommendations({
  gameIds: [1],
  newGamesCount: 1,
  excludeGameIds: [2]
})

Response examples:
SuccessError

{
  error: '',
  isLoading: false,
  data: {
    result: 0,
    details: {
      total_price: 16.8541811802,
      legs_count: 5,
      recommendations: [{
        sport: 1,
        sport_alias: 'Football',
        region: 10001,
        region_alias: 'World',
        competition: 3042,
        competition_name: 'International Friendlies',
        game: 29875685,
        home_team_name: 'Colombia',
        away_team_name: 'Costa Rica',
        start_time: '2026-06-01T23:00:00Z',
        market: 2276860663,
        market_type: 'OverUnder',
        tag: 106,
        selections: [6771477171],
        selection_prices: [1.77],
        is_player_market: false,
        reason: null
      }]
    }
  }
}

Response parameters:

Name	Description	Type	Values

total_price	Combined express odds across all returned legs (product of all selection_prices)	number	-
legs_count	Total number of legs (recommendations) in the response	number	-
recommendations	Full updated list of all recommended games	array	-
└─		object
└─ game	Game ID	number	-
└─ sport	Sport ID	number	-
└─ sport_alias	Sport alias	string	-
└─ region	Region ID	number	-
└─ region_alias	Region alias	string	-
└─ competition	Competition ID	number	-
└─ competition_name	Competition 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	Market ID	number	-
└─ market_type	Market type key (e.g. "OverUnder", "P1XP2")	string	-
└─ selections	Swarm selection IDs to add to betslip	array	-
└─ selection_prices	Odds for each selection	array	-
└─ tag	Internal AI tag for the recommendation	number	-
└─ is_player_market	Whether this is a player-specific market	boolean	true / false
└─ reason	AI explanation for the pick (currently always null)	string	-