agentutility(7)$ man win-prob
/win-prob
PRICE / CALL
$0.003
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
statlineCATEGORY
uncategorized
STATUS
● live
NAME
win-prob — estimates live in-game win probability for nfl, nba, mlb, nhl, and soccer from the current score and time remaining
SYNOPSIS
POST https://x402.agentutility.ai/win-prob
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Estimates live in-game win probability for NFL, NBA, MLB, NHL, and soccer from the current score and time remaining. Returns each team's win probability, the projected final margin, the size of the swing still possible, and human-readable drivers. Built-in scoring volatility for NFL/NCAAF/NBA/NCAAB/WNBA/MLB/NHL/soccer; override scoring_std for any sport. Statistical estimate, not betting advice. Use it as a live sports win probability API or in-game win chance calculator.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| sport | string | Sport/league: nfl, ncaaf, nba, ncaab, wnba, mlb, nhl, soccer/epl/mls. Case-insensitive. Use 'generic' with scoring_std for anything else. | optional |
| score_a | number | Current score of team A (the reference team). | required |
| score_b | number | Current score of team B. | required |
| time_remaining_fraction | number | Fraction of the game still to play, 0-1. Provide this OR minutes_remaining + minutes_total. | optional |
| minutes_remaining | number | Game minutes left (alternative to time_remaining_fraction). | optional |
| minutes_total | number | Total game minutes (e.g. 48 NBA, 60 NFL/NHL). | optional |
| pregame_spread | number | Optional expected FINAL margin for team A at kickoff (positive = A favored). Default 0 (even). | optional |
| scoring_std | number | Optional override of the final-margin standard deviation; required for sports without a built-in default. | optional |
| team_a_name | string | Optional label for team A. | optional |
| team_b_name | string | Optional label for team B. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| sport | string | — |
| win_probability_a | string | — |
| win_probability_b | string | — |
| favored | string | — |
| projected_final_margin | string | — |
| model | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/win-prob \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the win-prob tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- statlinewinprobwin-prob
- methods
- POST
- cluster
- statline
- price
- $0.003 USDC per call
SEE ALSO