generateRecommendationsByTotalOdd

Generates an AI-recommended express bet that matches a target total odd price. The AI picks games and markets whose combined odds are close to the requested total_odd_price. Used in the Bet Constructor feature.

This command requires the logged in session

Documentation

Try it now

Request parameters:

Name	Description	Type	Values	Default

totalOddPrice	Target combined express odds (e.g. possibleWin / stakeAmount)	number	-	-
minOddPerGame	Minimum allowed odd per individual game	number	-	-
maxOddPerGame	Maximum allowed odd per individual game	number	-	-
minGameCount	Minimum number of legs in the express	number	-	-
maxGameCount	Maximum number of legs in the express	number	-	-

Call example:
JavaScriptReact HookFlutter

generateRecommendationsByTotalOdd({
  totalOddPrice: 5,
  minOddPerGame: 1.5,
  maxOddPerGame: 3.5
})

Response examples:
SuccessError

{
  total_price: 3.728,
  target_price: 2,
  price_difference: 1.728,
  legs_count: 3,
  recommendations: [{
    sport: 1,
    sport_alias: 'Football',
    region: 10001,
    region_alias: 'World',
    competition: 3119,
    competition_name: 'U20 International Friendlies',
    game: 29977304,
    home_team_name: 'Jordan U20',
    away_team_name: 'Iraq U20',
    start_time: '2026-06-08T15:00:00Z',
    market: 2287306914,
    market_type: 'OverUnder',
    tag: 106,
    selections: [6800536844],
    selection_prices: [1.65],
    is_player_market: false,
    reason: null
  }]
}

Response parameters:

Name	Description	Type	Values

total_price	Actual combined odds of all returned legs	number	-
target_price	The requested totalOddPrice	number	-
price_difference	Difference between total_price and target_price	number	-
legs_count	Number of legs in the response	number	-
recommendations	List of recommended games	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", "TotalofSets")	string	-
└─ selections	Swarm selection IDs to add to betslip	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	-