# MLB Odds API

Get current and historical MLB odds from several bookmakers in a simple JSON API.

Not a developer? Current MLB odds can also be accessed in Excel or Google Sheets.

# MLB Odds API

Once you have your API key, current MLB odds can be queried with the following parameters:

The sport key baseball_mlb
The regions of desired bookmakers (us, us2, uk, eu or au)
Markets (h2h for moneyline, spreads or totals)
Odds format (decimal or American)
And your API key (get a free API key)

The API will return live and upcoming MLB games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.

Example Request

GET https://api.the-odds-api.com/v4/sports/baseball_mlb/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY

Example Response

[{
  "id": "5c4d8f368956b33f3f2639aed5152e2f",
  "sport_key": "baseball_mlb",
  "sport_title": "MLB",
  "commence_time": "2023-07-19T01:40:00Z",
  "home_team": "Seattle Mariners",
  "away_team": "Minnesota Twins",
  "bookmakers": [
    {
      "key": "draftkings",
      "title": "DraftKings",
      "last_update": "2023-07-18T03:56:37Z",
      "markets": [
        {
          "key": "h2h",
          "last_update": "2023-07-18T03:56:37Z",
          "outcomes": [
            {"name": "Minnesota Twins", "price": 105},
            {"name": "Seattle Mariners", "price": -125}
          ]
        },
        {
          "key": "spreads",
          "last_update": "2023-07-18T03:56:37Z",
          "outcomes": [
            {"name": "Minnesota Twins", "price": -200, "point": 1.5},
            {"name": "Seattle Mariners", "price": 170, "point": -1.5}
          ]
        },
        {
          "key": "totals",
          "last_update": "2023-07-18T03:56:37Z",
          "outcomes": [
            {"name": "Over", "price": -110, "point": 7.5},
            {"name": "Under", "price": -110, "point": 7.5}
          ]
        }
      ]
    },
    ...

See the API documentation for more details.

# MLB Bookmakers

The Odds API covers MLB odds from several bookmakers, including:

US Bookmakers: Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more
UK Bookmakers: Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more
EU Bookmakers: 1xBet, Pinnacle, Betclic, Betsson, Unibet and more
AU Bookmakers: Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more

See the full list of bookmakers

# MLB Markets

The Odds API covers MLB odds for several betting markets, including

Moneyline
Spreads (handicap)
Over/Under (totals)
Innings odds (for example, 1st 5 innings moneyline, spreads and totals)
MLB player props (US bookmakers only)

See the full list of betting markets.

# Latency

More information on odds latencies can be found here.

# Historical MLB Odds Data

Historical MLB odds are available from mid-2020 for featured markets (moneyline, spreads and totals). Learn more about historical odds data, or see the docs.

# Get Started

Get a free API key
Check out the API docs
Check out Python and NodeJS code samples (opens new window)

# More Odds

Odds are available for a wide range of sports. See the full list of available sports.