The API supports multiple betting strategies that allow you to control how bets are distributed across your active bookmaker sessions. Each strategy optimizes for different goals, from maximizing odds to ensuring total wager amounts.
When placing bets via the API, you can specify a strategy parameter along with strategy-specific parameters to control bet distribution.
{ "strategy": "fixed_wager", // ... other bet parameters }
Strategy ID: fixed_wager
Places the same stake amount on all active bookmaker sessions, regardless of the odds displayed. Each bookmaker receives an identical bet.
Use when: You want equal stakes across all bookmakers regardless of odds differences.
Parameters:
bet_amount - The stake amount to place on each sessionExample Request:
{ "session_id": "uuid-string", "category": "racing", "stake": 50.0, "bet_type": "non_promo", "track": "flemington", "race_num": 1, "race_type": "R", "date": "2026-01-15", "runner": "Horse Name", "target_odds": 3.5, "market": "win", "stake_type": "fixed", "strategy": "fixed_wager" }
Strategy ID: ensure_total_wager
Places bets in fixed chunks across sessions until reaching your total target wager amount. If a bookmaker fails to accept a bet, the system automatically reallocates the stake to other sessions to ensure the total target is met.
Use when: You have a specific total amount you want to wager and need to ensure it's fully placed, even if some bookmakers reject bets.
Parameters:
total_wager - The total amount you want to wager across all sessionschunk_size - The size of each bet chunk (e.g., 50.0 for $50 units)Example Request:
{ "session_id": "uuid-string", "category": "racing", "stake": 50.0, "bet_type": "non_promo", "track": "flemington", "race_num": 1, "race_type": "R", "date": "2026-01-15", "runner": "Horse Name", "target_odds": 3.5, "market": "win", "stake_type": "fixed", "strategy": "ensure_total_wager", "total_wager": 250.0, "chunk_size": 50.0 }
Strategy ID: choose_best_odds
The bot first checks odds across all active sessions, then selects the top N bookmakers with the highest odds. Only these selected bookmakers receive the bet; all others are skipped.
Use when: You want to bet only on the bookmakers offering the best odds, limiting exposure to lower-priced options.
Parameters:
bet_amount - The stake amount to place on each selected sessionbest_odds_count - The number of top bookmakers to select (e.g., 3 for top 3)Example Request:
{ "session_id": "uuid-string", "category": "racing", "stake": 50.0, "bet_type": "non_promo", "track": "flemington", "race_num": 1, "race_type": "R", "date": "2026-01-15", "runner": "Horse Name", "target_odds": 3.5, "market": "win", "stake_type": "fixed", "strategy": "choose_best_odds", "best_odds_count": 3 }
Strategy ID: minimum_odds
Only places bets on bookmakers where the odds meet or exceed your specified minimum threshold. Any bookmaker with odds below the threshold is skipped.
Use when: You have a minimum odds requirement and want to automatically filter out any bookmakers that don't meet it.
Parameters:
bet_amount - The stake amount to place on qualifying sessionsmin_odds - The minimum odds threshold (e.g., 6.0)Example Request:
{ "session_id": "uuid-string", "category": "racing", "stake": 50.0, "bet_type": "non_promo", "track": "flemington", "race_num": 1, "race_type": "R", "date": "2026-01-15", "runner": "Horse Name", "target_odds": 3.5, "market": "win", "stake_type": "fixed", "strategy": "minimum_odds", "min_odds": 6.0 }
Strategy ID: high_odds_first
Routes your total wager starting from the highest odds bookmaker first. If the bet is rejected or only partially accepted, the remaining amount automatically spills over to the next best odds bookmaker, and so on.
Use when: You want to maximize returns by prioritizing the best odds, with automatic fallback to lower odds if limits are hit.
Parameters:
total_wager - The total amount you want to wagerExample Request:
{ "session_id": "uuid-string", "category": "racing", "stake": 500.0, "bet_type": "non_promo", "track": "flemington", "race_num": 1, "race_type": "R", "date": "2026-01-15", "runner": "Horse Name", "target_odds": 3.5, "market": "win", "stake_type": "fixed", "strategy": "high_odds_first", "total_wager": 1000.0 }
Strategy ID: fixed_profit
Calculates different stake sizes for each bookmaker based on their individual odds, ensuring that if any bet wins, you achieve the same fixed profit amount. Stakes are automatically weighted so that a win at any bookmaker produces your target profit.
Use when: You want to guarantee a specific profit amount regardless of which bookmaker's bet wins, accepting variable stake sizes across different odds.
Parameters:
target_profit - The desired profit amount if any bet winsExample Request:
{ "session_id": "uuid-string", "category": "racing", "stake": 50.0, "bet_type": "non_promo", "track": "flemington", "race_num": 1, "race_type": "R", "date": "2026-01-15", "runner": "Horse Name", "target_odds": 3.5, "market": "win", "stake_type": "fixed", "strategy": "fixed_profit", "target_profit": 200.0 }
If a strategy cannot be executed (e.g., insufficient sessions, no sessions meet minimum odds), the API will return an error response:
{ "success": false, "error": "Strategy execution failed: No sessions meet minimum odds requirement", "error_code": "STRATEGY_FAILED" }