get_win_probability

10 creditsTime-seriesPOST /v1/get_win_probability

Data refreshed Nov 12, 2026 · changelog

A match's win-probability worm over by over, and the balls that swung it

Use it when you want a limited-overs match's win-probability worm over by over, and the balls that swung it.

Parameters

match_idstringrequired: Match id from get_matches.
leagueenum: cricket | test | odi | t20i | ipl | bbl | psl | cpl | blast | hundred | sa20 | ilt20 | county | wbbl | wpl | hundred_womenoptional: League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.

Notes

Over MCP, ask for it in plain English and the client calls get_win_probability itself. Point any MCP client at https://mcp.yorkerapi.com/mcp?key=YOUR_API_KEY.
Each call costs 10 credits, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.yorkerapi.com/v1/get_win_probability \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "match_id": "1473511"
}'

Response

json

{
  "match_id": "1473511",
  "team1_id": "royal-challengers-bengaluru",
  "team2_id": "punjab-kings",
  "winner_id": "royal-challengers-bengaluru",
  "overs": [
    {
      "innings": 1,
      "over": 0,
      "runs": 13,
      "wickets": 0,
      "batting_team_id": "royal-challengers-bengaluru",
      "win_prob": 0.6133,
      "wickets_in_over": 0,
      "runs_in_over": 13,
      "team1_win_prob": 0.6133
    },
    {
      "innings": 1,
      "over": 1,
      "runs": 19,
      "wickets": 1,
      "batting_team_id": "royal-challengers-bengaluru",
      "win_prob": 0.523,
      "wickets_in_over": 1,
      "runs_in_over": 6,
      "team1_win_prob": 0.523
    },
    {
      "innings": 1,
      "over": 2,
      "runs": 30,
      "wickets": 1,
      "batting_team_id": "royal-challengers-bengaluru",
      "win_prob": 0.5532,
      "wickets_in_over": 0,
      "runs_in_over": 11,
      "team1_win_prob": 0.5532
    }
  ],
  "biggest_swings": [
    {
      "innings": 2,
      "delivery": "8.3",
      "batter": "P Simran Singh",
      "bowler": "KH Pandya",
      "runs_total": 0,
      "wicket_kind": "caught",
      "change_for_team1": 0.1146
    },
    {
      "innings": 2,
      "delivery": "4.7",
      "batter": "Priyansh Arya",
      "bowler": "JR Hazlewood",
      "runs_total": 0,
      "wicket_kind": "caught",
      "change_for_team1": 0.0978
    },
    {
      "innings": 2,
      "delivery": "9.4",
      "batter": "SS Iyer",
      "bowler": "R Shepherd",
      "runs_total": 0,
      "wicket_kind": "caught",
      "change_for_team1": 0.0936
    }
  ],
  "count": 40,
  "method": "Our model's chance the batting side wins after each ball: score against the competition's par, wickets in hand, balls left, the target in a chase, and the two sides' ratings before the match. team1_win_prob is the same number from team 1's side."
}