get_winner_odds

5 creditsTime-seriesPOST /v1/get_winner_odds

The four majors' winner prices by sportsbook before the first round: opening and latest, with implied probability

Use it when you are backtesting or modelling a major's outright market: each sportsbook's opening price and latest price before the first round for the favourites, or how one golfer's price moved across majors. The four men's majors: weekly snapshots from 2021, daily for an upcoming major.

Parameters

tournament_idstringoptional: A major's tournament id from list_tournaments (major: true).
seasonstring | numberoptional: ESPN's season year, e.g. 2025: all four majors of that season (the 2020 U.S. Open and the November 2020 Masters are season 2021).
majorenum: masters | pga_championship | us_open | the_openoptional: Only this major (with season, or alone for every year).
player_idstringoptional: Player id from search_players: this golfer across the majors he was priced for.
bookmakerstringoptional: Bookmaker key, e.g. draftkings, fanduel, betmgm, bovada, betonlineag, espnbet, pinnacle, mybookieag.
limitintegeroptional: Golfers per tournament, favourites first (default 20, max 200). Ignored with player_id.

Notes

Over MCP, ask for it in plain English and the client calls get_winner_odds itself. Point any MCP client at https://mcp.birdieapi.com/mcp?key=YOUR_API_KEY.
Each call costs 5 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.birdieapi.com/v1/get_winner_odds \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "tournament_id": "401580344",
  "limit": 3
}'

Response

json

{
  "tournaments": [
    {
      "tournament_id": "401580344",
      "name": "Masters Tournament",
      "season": 2024,
      "start_date": "2024-04-11",
      "snapshots": 51,
      "first_captured_at": "2023-04-21T11:55:40.000Z",
      "last_captured_at": "2024-04-05T11:55:39.000Z",
      "golfers_priced": 121,
      "golfers_returned": 3,
      "golfers": [
        {
          "player_id": "9478",
          "player_name": "Scottie Scheffler",
          "median_implied_prob_opening": 0.1,
          "median_implied_prob_latest": 0.2,
          "books": "[6 items]"
        },
        {
          "player_id": "3470",
          "player_name": "Rory McIlroy",
          "median_implied_prob_opening": 0.0909,
          "median_implied_prob_latest": 0.0769,
          "books": "[6 items]"
        },
        {
          "player_id": "9780",
          "player_name": "Jon Rahm",
          "median_implied_prob_opening": 0.1176,
          "median_implied_prob_latest": 0.0702,
          "books": "[6 items]"
        }
      ]
    }
  ],
  "count": 1,
  "note": "More golfers were priced than returned; the favourites by median latest implied probability come first. Pass limit (up to 200), or a player_id."
}