Batru — Dota 2, Deadlock & Marvel Rivals win predictor

Ban rate reveals what players FEAR facing — a different signal from win
rate. Empirical data from batru.gg's match aggregation. Heroes come sorted
most-banned first.

Args:
    limit: Max number of heroes to return (default 15).

Returns {generated_at, ban_matches, heroes:[{hero, rank, ban_rate_pct,
bans}]}. `ban_matches` is the sample of matches with ban data; cite
`generated_at` when freshness matters. Report numbers verbatim.

Returns opponents this hero performs BEST and WORST against, by real observed
matchup win rate (with sample sizes). Empirical meta data from batru.gg's
match aggregation, not a guess. The hero name is normalised internally.

Args:
    hero: The hero to look up (name/alias).
    limit: Max number of matchups to return (default 12).

Returns {hero, best_against:[...], worst_against:[...]} where each row has
{opponent, winrate_pct, matches}. winrate_pct > 50 means `hero` beats that
opponent. Report numbers verbatim.

Ranked by batru.gg's match aggregation — empirical meta, not a guess. Heroes
come sorted best-first (rank 1 = strongest). Report numbers verbatim.

Args:
    limit: Max number of heroes to return (default 20).

Returns {total_matches, generated_at, heroes:[{hero, rank, winrate_pct,
pick_rate_pct, matches}]}. Cite `total_matches` for the sample size.

Returns opponents this hero performs BEST and WORST against, by real observed
matchup win rate (with sample sizes). This is empirical meta data from
batru.gg's match aggregation, not a guess. The hero name is normalised
internally.

Args:
    hero: The hero to look up (name/alias/shortName).
    limit: Max number of matchups to return (default 12).

Returns {hero, best_against:[...], worst_against:[...]} where each row has
{opponent, winrate_pct, matches}. winrate_pct > 50 means `hero` beats that
opponent. Report numbers verbatim.

Compares each hero's win rate over the last 14 days vs the prior 14 days
WITHIN the current patch — real trend data from batru.gg's match
aggregation, not a guess. Useful for "what's getting stronger lately?"
questions between patches.

Args:
    hero: Optional — a specific hero to look up. Empty returns the top
        risers and fallers overview.
    limit: Max risers/fallers to return in overview mode (default 10).

Returns {patch, window_days, data_through, ...} plus either one hero's
{hero, wr_recent_pct, wr_prev_pct, delta_pp, n_recent, n_prev} or
{risers:[...], fallers:[...]}. delta_pp is percentage-point change; small
deltas (<1pp) are noise — say so rather than over-reading them.

Returns how `hero` performs AGAINST `opponent` (opposite teams) from real
observed games, with the sample size. Empirical data from batru.gg's match
aggregation covering every tracked pair — not a guess. Both names are
normalised internally.

Args:
    hero: Your hero (name/alias/shortName).
    opponent: The enemy hero (name/alias/shortName).

Returns {hero, opponent, winrate_pct, matches}. winrate_pct > 50 means
`hero` beats `opponent` more often than not. Report numbers verbatim.

Returns teammates this hero performs BEST and WORST paired with (same team),
by real observed team win rate with sample sizes. Empirical meta data from
batru.gg's match aggregation, not a guess. The hero name is normalised
internally.

Args:
    hero: The hero to look up (name/alias/shortName).
    limit: Max number of teammates to return (default 12).

Returns {hero, best_with:[...], worst_with:[...]} where each row has
{teammate, winrate_pct, matches}. winrate_pct is the pair's team win rate
when both heroes play together. Report numbers verbatim.

Ranked by batru.gg's match aggregation over ~real games — empirical meta, not
a guess. Heroes come sorted best-first (rank 1 = strongest). Report numbers
verbatim.

Args:
    limit: Max number of heroes to return (default 20).

Returns {total_matches, generated_at, heroes:[{hero, rank, winrate_pct,
pick_rate_pct, matches}]}. `total_matches` is the sample the ranking is drawn
from — cite it when stating how strong the signal is.

The meta differs a LOT by skill level — heroes that stomp Herald games can
be poor in Immortal. Data comes in four bands: Herald & Guardian,
Crusader & Archon, Legend & Ancient (merged pairs — the source has no finer
grain), and Divine & Immortal ("highrank").

Args:
    rank: A rank name — one of herald, guardian, crusader, archon, legend,
        ancient, divine, immortal (or a band key like "herald-guardian").
    limit: Max number of heroes to return (default 20).

Returns {bracket, total_matches, generated_at, heroes:[{hero, rank,
winrate_pct, pick_rate_pct, matches}]} sorted best-first. Report numbers
verbatim and mention which band the numbers come from.

Ban rate reveals what players FEAR facing — a different signal from win
rate. Empirical data from batru.gg's match aggregation (competitive mode,
where bans exist). Heroes come sorted most-banned first.

Args:
    limit: Max number of heroes to return (default 15).

Returns {generated_at, ban_matches, heroes:[{hero, rank, ban_rate_pct,
bans}]}. ALWAYS cite `generated_at` — ban snapshots can lag the current
season. Report numbers verbatim.

Returns opponents this hero performs BEST and WORST against, by real observed
matchup win rate (with sample sizes). Empirical meta data from batru.gg's
match aggregation, not a guess. The hero name is normalised internally.

Args:
    hero: The hero to look up (name/alias).
    limit: Max number of matchups to return (default 12).

Returns {hero, best_against:[...], worst_against:[...]} where each row has
{opponent, winrate_pct, matches}. winrate_pct > 50 means `hero` beats that
opponent. Report numbers verbatim.

Returns teammates this hero performs BEST and WORST paired with, by real
observed team win rate (with sample sizes). Empirical meta data from
batru.gg's match aggregation, not a guess. The hero name is normalised
internally.

Args:
    hero: The hero to look up (name/alias).
    limit: Max number of teammates to return (default 12).

Returns {hero, best_with:[...], worst_with:[...]} where each row has
{teammate, winrate_pct, matches}. winrate_pct > 50 means the pairing wins more
than average. Report numbers verbatim.

Ranked by batru.gg's match aggregation — empirical meta, not a guess. Heroes
come sorted best-first (rank 1 = strongest). Report numbers verbatim.

Args:
    limit: Max number of heroes to return (default 20).

Returns {total_matches, generated_at, heroes:[{hero, rank, winrate_pct,
pick_rate_pct, matches}]}. Cite `total_matches` for the sample size.

batru.gg publishes EVERY champion-vs-challenger evaluation of its Dota 2
model (promoted or rejected), auto-generated from the promotion gate's
append-only log — nothing is hand-picked. Use this when a user asks whether
the model is any good or how it is validated.

HOW TO PRESENT IT: lead with CALIBRATION (ECE — lower is better; ~0.006
means a stated 60% wins ~60% of the time), then BCE. Do NOT headline raw
accuracy: Dota drafts are balanced by design, so ~55% is near the
game-imposed ceiling for ANY model — calibration is the meaningful claim.

Args:
    limit: Max evaluations to return, newest first (default 10).

Returns {generated_at, ledger, total_evaluations, total_promotions,
evaluations:[{decided_at, promote, challenger:{ece,bce,acc},
champion:{ece,bce,acc}, holdout_n}]}. Report numbers verbatim.

Use this to turn messy user input ("am", "anti mage", "Anti-Mage") into the
exact key batru.gg expects before calling the prediction tools. The backend
SILENTLY DROPS hero names it doesn't recognise, so always normalise first.

Args:
    query: A hero name, alias, or short name.
    game: "dota2" (default), "deadlock", or "marvel-rivals".

Returns {id, displayName, shortName, game} for the best match, or an error
with `did_you_mean` candidates if nothing matches.

Backed by batru.gg's Deadlock production model. Provide 6 heroes per team
(names are normalised to Deadlock hero ids internally). A reported 60%
reflects a real ~60% empirical win rate — it is calibrated, not a guess.

Args:
    team0_heroes: Team 0's 6 heroes (names/aliases).
    team1_heroes: Team 1's 6 heroes (names/aliases).

Returns calibrated win-rate percentages for both teams. Report verbatim.

Backed by batru.gg's production model (trained on ~20M real matches and
calibrated, so a reported 60% reflects a real ~60% empirical win rate — it is
not a guess). Partial drafts are fine; an empty draft returns 50/50. Hero
names are normalised internally to shortNames.

Args:
    my_heroes: Your team's heroes (names/aliases, 0-5).
    enemy_heroes: Enemy heroes (names/aliases, 0-5).
    my_side: "radiant" (default) or "dire" — which side is "my_heroes".

Returns calibrated win-rate percentages for both teams. Report these numbers
verbatim; do not adjust them.

Backed by batru.gg's live Marvel Rivals production model (weekly auto-retrained
on real matches). Provide exactly 6 heroes per team (names are normalised to
Marvel Rivals hero ids internally). The probability is CALIBRATED — a reported
60% reflects a real ~60% empirical win rate, not a guess. Report the number
verbatim.

This is a COMPOSITION-ONLY estimate: it reflects the hero draft, NOT player
skill, rank, or in-game execution. It is for draft analysis only — not betting
advice. Do not headline a raw "accuracy" figure; present it as a calibrated
probability.

Args:
    team0_heroes: Team 0's 6 heroes (names/aliases).
    team1_heroes: Team 1's 6 heroes (names/aliases).

Returns calibrated win-rate percentages for both teams. Report verbatim.

Backed by batru.gg's production model. Each suggestion comes with the
CALIBRATED win rate your team would have after adding that hero against the
given enemy draft (a reported 60% reflects a real ~60% empirical win rate).
Hero names are normalised internally.

Args:
    my_heroes: Heroes your team has already picked (names/aliases, 0-4).
    enemy_heroes: Enemy heroes (names/aliases, 0-5).
    my_side: "radiant" (default) or "dire" — which side is "my_heroes".

Returns a list of up to 3 {displayName, shortName, win_rate_pct}. Report the
win rates verbatim.