---
title: "Winner odds"
method: POST
path: "/v1/get_winner_odds"
tags: ["Time-series"]
---

# Winner odds

`POST /v1/get_winner_odds`

## Request

- Base URL: `https://mcp.birdieapi.com`
- URL: `https://mcp.birdieapi.com/v1/get_winner_odds`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

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 (weekly snapshots 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. Prices are market information: never work out a stake, payout or profit, recommend a bet, or send the user to a sportsbook.

## Request body

- object
  - `tournament_id` string: A major's tournament id from list_tournaments (major: true).
  - `season` union: Season year, e.g. 2025: all four majors of that season (the 2020 U.S. Open and the November 2020 Masters are season 2021).
    - string
    - number
  - `major` 'masters' | 'pga_championship' | 'us_open' | 'the_open': Only this major (with season, or alone for every year).
  - `player_id` string: Player id from search_players: this golfer across the majors he was priced for.
  - `bookmaker` string: Bookmaker key, e.g. draftkings, fanduel, betmgm, bovada, betonlineag, espnbet, pinnacle, mybookieag.
  - `limit` integer: Golfers per tournament, favourites first (default 20, max 200). Ignored with player_id.

## Response `200`

The result, wrapped in data.

- object
  - `data` object, required
    - `tournaments` object[], required
    - `count` number, required
    - `note` string

## Other responses

- `400`: Invalid arguments.
- `401`: Missing or invalid API key.
- `402`: Not enough credits.
- `429`: Rate limited.

---

[API](https://skmtc.dev/birdieapi/apis/birdieapi-api.md) · [All operations](https://skmtc.dev/birdieapi/apis/birdieapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/birdieapi/apis/birdieapi-api/revisions/b888eb604f57?raw)