Infersports

- Live football & basketball odds (Asian-handicap lines)
- De-vigged sharp (Pinnacle) fair probabilities
- Live scores, opening lines, and value detection
- Quarter lines with win/half-win/push outcomes
- Read-only, no API key required

- get_sharp_line: Answer an odds question about a fixture in ONE call (natural language in, worked line out).

Resolves the fixture, picks the consensus line, the best price per outcome across books, and
de-vigged fair odds from the sharpest book — returning a ready-to-read `summary plus the
full comparison. Prefer this over chaining find_match → compare_lines.

Args:
query: natural-language fixture, e.g. "Arsenal vs Man City" or a single team.
market_type: "1x2", "asian_handicap" (default) or "totals".
period: "full_time" (default) or "half_time".
format: odds format — decimal | hk | malay | american | indonesian | probability.
sport: optional filter — "football" or "basketball".
date: optional UTC date "YYYY-MM-DD" to disambiguate same-name fixtures.
verbosity: "full" (default) or "terse". "terse" empties the per-book books array inside
comparison to save tokens; the summary and worked numbers are kept either way.

On an ambiguous query, status is "ambiguous" and ask_user carries a disambiguation
prompt — do not assume a match; ask the user or re-call with a more specific query. A
decision block (safe_to_proceed / ask_user / next_action) pre-computes the
go/no-go — branch on it instead of re-judging the result.
- find_match: Find a football/basketball fixture by natural-language name.

Returns the best-matching event (with id, teams, league, kickoff, live score, the live match
clock e.g. "2h 47" or "ht", and a confidence score) plus alternatives. Use the returned
event_id with get_match_odds / compare_lines.
A decision block tells you whether it's safe_to_proceed and the suggested
next_action (or ask_user when ambiguous).
- get_match_odds: Get all current odds for a match across bookmakers.

Args:
event_id: event id from find_match / list_today_matches (e.g. "evt_…").
markets: optional filter — any of "1x2", "asian_handicap", "totals".
bookmakers: optional filter — bookmaker keys, e.g. ["pinnacle", "crown"].
period: optional — "full_time" or "half_time" (default: both).
format: odds format — decimal | hk | malay | american | indonesian | probability.
- compare_lines: Compare one market across all bookmakers for a match.

Args:
event_id: event id (e.g. "evt_…").
market_type: "1x2", "asian_handicap" (default) or "totals".
period: "full_time" (default) or "half_time".
format: display odds format (analytics are computed in decimal regardless).
verbosity: "full" (default) or "terse". "terse" drops the per-book books array (the bulk
of the payload) and returns only the worked answer (best_prices / consensus_line /
fair_odds / summary).
- explain_handicap: Explain an Asian handicap line.

Splits a quarter line into its components (e.g. -0.75 → -0.5 / -1.0) and states the
full-win / half-win / push / half-loss / full-loss conditions. line must be a multiple
of 0.25.
- list_today_matches: List today's (UTC) fixtures — "what games are on today / right now?".

Each fixture carries its status, live score, the live match clock (upstream minute text,
verbatim e.g. "1h 25" / "2h 47" / "ht") when in-running, and a ready-to-read summary (live
score & clock, or the kickoff time). Read clock for the real minute rather than estimating it
from kickoff. clock is null pre-match.

Args:
sport: optional filter — "football" or "basketball".
status: optional filter — "live", "scheduled" or "finished".
league: optional league filter — a name (fuzzy-matched, e.g. "World Cup") or an external id ("lg_…").
limit: max fixtures to return (1–200, default 50).
timezone: optional IANA timezone (e.g. "America/New_York", "Asia/Shanghai") to render each
fixture's kickoff in its summary as local time; default UTC.
- list_events: List the fixtures for a calendar day — or a bounded [date, date_to] range.

Unlike list_today_matches (today + anything still live), this is a strict window for whatever
date you ask for. Pass date_to (inclusive, max 31 days after date) to cover a whole
tournament window in ONE call — "all group-stage matches June 11–28" needs no per-day loop. UTC
is canonical: pass an IANA timezone and the day boundaries are computed in that zone (so
"June 12 in Shanghai" excludes a match that is still June 11 / already June 13 locally); each
fixture keeps its UTC scheduled_at and adds scheduled_at_local. Capped to limit
(truncated flags overflow) — narrow with sport/status/league rather than paging.

Args:
date: REQUIRED calendar day "YYYY-MM-DD" (e.g. "2026-06-12") — the window start.
date_to: optional inclusive end day "YYYY-MM-DD" (max 31 days after date); omit for a
single day.
timezone: optional IANA timezone (e.g. "Asia/Shanghai", "America/New_York") for the day
boundary; default is the UTC day.
sport: optional filter — "football" or "basketball".
status: optional filter — "scheduled", "live" or "finished".
league: optional league filter — a name (fuzzy-matched, e.g. "World Cup") or an external id ("lg_…").
limit: max fixtures to return (1–200, default 50).
- match_info: Get the basics for a match in ONE call: the score, whether it's live, when it kicks off, and who's favored.

No betting knowledge needed — this answers "who's winning?", "what's the score?", "what time does
Brazil play (in my timezone)?", "who's the favorite?". Returns the live score + match clock, the
status, the kickoff time (in timezone if you pass an IANA name like "America/New_York"), the
favored team with a plain win probability (de-vigged from the 1x2 line), and a ready-to-read
summary you can quote directly.

On an ambiguous query, status is "ambiguous" and ask_user carries a prompt — do not guess.
favorite is best-effort (null when no 1x2 is on file for the fixture).
- list_bookmakers: List the bookmakers available on your tier.

Returns the curated catalogue (each with key, name and class = "sharp" | "asian")
plus a note on tier coverage. Free tier excludes the sharp book (Pinnacle). Use the returned
key values in the bookmakers filter of get_match_odds / compare_lines.
- get_opening_line: Get the opening odds (初盘) for a fixture, paired with the current price, in ONE call.

Resolves the fixture, then for each book returns its true opening (first-seen) quote alongside
the current quote — so you can read movement directly. For 1x2 that's a price move; for totals/AH
compare line (the opening line) vs current_line to read the line move (the sharp book often
opens days earlier). A market with no opening yet on file is omitted.

On an ambiguous query, status is "ambiguous" and ask_user carries a disambiguation
prompt — do not assume a match. Best-effort: a book/line with no opening on file is omitted.
- find_value: Find +EV value bets in a fixture — where a book's price beats the sharp fair line — in ONE call.

On an ambiguous query, status is "ambiguous" and ask_user carries a prompt — do not
guess. Needs the sharp book to de-vig; on the Free tier note flags that fair is approximate.
- compare_prob: Judge an external probability (e.g. a Polymarket/Kalshi price) against our sharp fair line — ONE call.

Resolves the fixture, de-vigs the sharp book to a fair probability (power de-vig for 3-way 1x2),
and reports the edge fair_prob − external_prob in percentage points, the ROI, and a verdict
(good / marginal / no_edge). DETECTION ONLY: InferSports never ingests prediction-market data,
sizes a stake, or picks — it gives you the sharp reference and the gap; the call is yours.

Args:
query: natural-language fixture, e.g. "France vs Argentina" or a single team.
external_prob: the external implied probability for outcome, in (0,1). Pre-net it for the
venue's fee/spread (e.g. a Polymarket YES ask of 0.55 → 0.55).
market_type: "1x2" (default; the prediction-market-comparable moneyline), "asian_handicap"
(only ±0.5 maps cleanly to a binary), or "totals".
period: "full_time" (default) or "half_time".
outcome: which leg the probability is for — home/draw/away (1x2), home/away (AH), over/under.
external_label: optional source label echoed back, e.g. "polymarket" | "kalshi".
sport: optional filter — "football" or "basketball".
date: optional UTC date "YYYY-MM-DD" to disambiguate same-name fixtures.

Read caveats before acting: a 1x2 fair is regulation 90-min (a prediction market that includes
extra time / "to advance" is a different market); quarter/integer AH carries push mass. On an
ambiguous query status is "ambiguous" — do not guess. status is "no_line" when no sharp
fair is available to judge against.
- score_prob: Market-implied correct-score probabilities for ONE football match — ONE call.

Inverts the de-vigged 1x2 (power de-vig) + totals prices into a bivariate-Poisson
(Dixon-Coles) score grid and returns the top-K scorelines with probabilities, the
fitted goal rates (lambda_home/lambda_away), and how much probability mass the list
covers. The asian-handicap fair price is held out of the fit and reported as
ah_ev_check (≈0 means the three markets are internally consistent). This is the
market's own distribution, never an InferSports prediction. Football only, one match
per call.

Args:
query: natural-language fixture, e.g. "Mexico vs South Africa" or a single team.
sport: optional filter; only "football" is supported by this tool.
date: optional UTC date "YYYY-MM-DD" to disambiguate same-name fixtures.
top: how many scorelines to return (default 5, max 10).
- find_arbitrage: Find cross-book arbitrage in a fixture — a guaranteed-profit price split — in ONE call.

On an ambiguous query, status is "ambiguous" and ask_user carries a prompt — do not guess.
- scan_slate: Scan today's whole slate in ONE call — each fixture with honest status + value/arb signal.

The batch alternative to looping find_match → get_sharp_line per match. Returns every fixture in
the filter with its status (finished is excluded from "live"), live score/clock, and a
pre-computed value/arb signal; value/arb matches are sorted to the top and the list is truncated
to limit (so truncation drops the quiet ones). Line movement is NOT included (that needs the
opening lookup) — drill into a single fixture with get_opening_line. DETECTION ONLY / read-only.

Args:
sport: optional filter — "football" or "basketball".
status: optional filter — "live" | "scheduled" | "finished".
league: optional league filter — a name (fuzzy-matched, e.g. "World Cup") or an external id (lg_…).
markets: optional — limit the value/arb scan to "1x2"/"asian_handicap"/"totals" (default all).
period: optional — "full_time" or "half_time" (default both).
min_edge_pct: value threshold for the per-match signal (default 1.0).
min_margin_pct: arbitrage threshold for the per-match signal (default 0.0).
only_signal: if true, return only fixtures that have a value or arb signal.
format: odds format — decimal | hk | malay | american | indonesian | probability.
limit: max entries to return, signal-first (default 20, max 100).
- list_results: Look back at finished-match scores from the 30-day results cache, most-recent-first.

Args:
date: optional UTC kickoff date "YYYY-MM-DD" — the day the match was played.
team: optional case-insensitive substring matched against either team name.
league: optional case-insensitive substring matched against the league name.
limit: max results to return, most-recent-first (1–200, default 50).
- get_result: Get the cached final result for ONE finished match by event id.

Returns the final score, red cards and finished time. status` is "found" or "not_found" (the
match isn't in the 30-day cache). Results-only — no odds.

Args:
event_id: event id (e.g. "evt_…") from find_match / list_results.