birdieapi-com Time Series API

openapi: 3.2.0
info:
  title: BirdieAPI Time Series API
  version: 1.0.0
  description: BirdieAPI golf data. Every tool is a POST to /v1/{tool} with a JSON body of its arguments and costs the credits in x-credits. The same tools are an MCP server at https://mcp.birdieapi.com/mcp and free accounts get credits every month at https://birdieapi.com/signup
  termsOfService: https://birdieapi.com/terms
  contact:
    name: BirdieAPI support
    email: support@birdieapi.com
    url: https://birdieapi.com/docs
servers:
- url: https://mcp.birdieapi.com
security:
- apiKey: []
- bearer: []
tags:
- name: Time-series
paths:
  /v1/get_winner_odds:
    post:
      operationId: get_winner_odds
      summary: Winner odds
      description: '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.'
      tags:
      - Time-series
      x-credits: 5
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tournament_id:
                  description: 'A major''s tournament id from list_tournaments (major: true).'
                  type: string
                season:
                  description: 'Season year, e.g. 2025: all four majors of that season (the 2020 U.S. Open and the November 2020 Masters are season 2021).'
                  type:
                  - string
                  - number
                major:
                  description: Only this major (with season, or alone for every year).
                  type: string
                  enum:
                  - masters
                  - pga_championship
                  - us_open
                  - the_open
                player_id:
                  description: 'Player id from search_players: this golfer across the majors he was priced for.'
                  type: string
                bookmaker:
                  description: Bookmaker key, e.g. draftkings, fanduel, betmgm, bovada, betonlineag, espnbet, pinnacle, mybookieag.
                  type: string
                limit:
                  description: Golfers per tournament, favourites first (default 20, max 200). Ignored with player_id.
                  type: integer
                  minimum: 1
                  maximum: 200
              additionalProperties: false
      responses:
        '200':
          description: The result, wrapped in data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      tournaments:
                        type: array
                        items:
                          type: object
                          propertyNames:
                            type: string
                          additionalProperties: {}
                      count:
                        type: number
                      note:
                        type: string
                    required:
                    - tournaments
                    - count
                    additionalProperties: false
                required:
                - data
        '400':
          description: Invalid arguments.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: Not enough credits.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
    bearer:
      type: http
      scheme: bearer
      description: The same API key as a bearer token.
externalDocs:
  description: Documentation
  url: https://birdieapi.com/docs