BetBuilders AI

Use this when the user asks how likely several things are to happen together in the same match, for example a home win with more than 2.5 goals and a named player scoring. Call get_match_prediction first and pass ids from its outcome_ids. Returns the joint probability of all the outcomes (computed exactly from the model's score matrix for team-level outcomes, and from 20,000 simulated matches when player or corner outcomes are included), how much the outcomes depend on each other compared with treating them as independent, and any outcomes that contradict each other. Read-only statistics.

combination_probability

Use this to read the full content of a result returned by search (a match prediction with analysis, or an article).

fetch

Use this when the user asks about upcoming (or very recent) football or Swedish hockey matches and you need the match_id: by team ("Arsenal", "Arsenal vs Chelsea"), by league, or by date. Returns kickoff time, the model's win/draw/loss probabilities and a link per match.

find_matches

Use this when the user asks for standings or which teams over- or under-perform: the league table with points, expected points, xG, xGA and xGD per match and playing style (football), or points, regulation/overtime wins, xG and special teams (hockey).

get_league_table

Use this when the user wants a deeper look at a match: the written analysis, recent form, the xG form curve (xG and xGA per match over the last 10 games with a rising/falling/stable trend), league-table position with xG ranks, KPIs, key players, goalkeepers, head-to-head and venue record for both teams. Use get_match_prediction for the probabilities alone.

get_match_analysis

Use this when the user asks who will win, the likely score, how many goals will be scored, or how likely an outcome is in a specific football or Swedish hockey match. Returns BetBuilders AI's model forecast: win, draw and loss probabilities (football after 90 minutes; hockey after 60 minutes and including overtime), expected goals, the most likely scorelines, the probability distribution of total goals, the probability that both teams score, the written preview, and outcome_ids that combination_probability accepts. Use get_match_analysis instead for form, xG trends and statistics.

get_match_prediction

Use this to search BetBuilders AI for matches (by team names) and published analysis articles. Returns ids, titles and URLs; pass an id to fetch for the full text.

search

Use this for what-if questions about a specific match: a key player missing or coming back, a different goalie, a stronger or weaker team level, a different formation (football) or a neutral venue. Runs BetBuilders AI's match simulator on the predicted line-ups with your changes and returns the scenario next to the unchanged baseline (probabilities, expected goals, likely scores and scorers). Player names must be in the predicted line-up or squad; the error message lists them if not.

simulate_match

Use this when the user asks about one team rather than a match: table position, points vs expected points, xG/xGA/xGD per match with league ranks, playing style, KPIs, the xG form curve with trend, streaks, home/away record, key players, goalkeepers, recent results and the next match. Covers BetBuilders AI's football leagues and SHL/HockeyAllsvenskan.

get_team_stats