get_winner_odds
Read-only
Use for the pre-tournament winner prices of the four men's majors by sportsbook, and how they moved: for each golfer and book the opening price (the first snapshot) and the latest price before the first round, with the implied probability, from The Odds API (the archive for every major from 2021 plus the 2020 U.S. Open, then refreshed daily while a major's market is open, every six hours in tournament week). For past majors the latest price can be up to a week before the first tee time; round, matchup and finishing-position markets are not held. Pass tournament_id, or season (all four majors), or player_id (one golfer across the majors). Costs 5 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Golfers per tournament, favourites first (default 20, max 200). Ignored with player_id. | |
| major | No | Only this major (with season, or alone for every year). | |
| season | No | 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). | |
| bookmaker | No | Bookmaker key, e.g. draftkings, fanduel, betmgm, bovada, betonlineag, espnbet, pinnacle, mybookieag. | |
| player_id | No | Player id from search_players: this golfer across the majors he was priced for. | |
| tournament_id | No | A major's tournament id from list_tournaments (major: true). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| count | Yes | ||
| tournaments | Yes |