Skip to content

MLS Odds API ​

The Odds API covers MLS (Major League Soccer) odds for live and upcoming matches in a simple JSON API.

Not a developer? Current MLS odds can also be accessed in Excel or Google Sheets. For website owners, the odds widget brings bookmaker odds into websites with a simple HTML tag.

Features ​

  • MLS odds are covered for live and upcoming matches.

  • Featured markets, including 3-way moneyline, spreads, totals are covered for several bookmakers. See the full list of bookmakers.

  • Odds are refreshed at regular intervals. More information on update intervals can be found here.

  • MLS scores are covered, with final scores available for matches completed up to 3 days ago.

  • Current odds data and scores are available on all usage plans, including the free usage plan.

  • Historical MLS odds data is available from Jun 2020 on paid usage plans. More information on historical odds data can be found here.

  • The API response includes deep links to bookmaker websites.

Querying MLS Odds ​

Featured markets (3-way moneyline, spreads and totals) can be queried using the odds endpoint.

Parameters

To query current MLS odds for featured markets, the following parameters need to be provided:

  • sport   In this case soccer_usa_mls
  • regions   Regions of bookmakers to return, for example us
  • markets   For example, h2h for 3-way moneyline, spreads, totals
  • oddsFormat   decimal or american. This example uses american
  • apiKey   Get a free API key

See the documentation for more options

Example API Request

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

Example API Response

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

json
[{
    "id": "dd7940be5e7a6885a2ceb2e697719e43",
    "sport_key": "soccer_usa_mls",
    "sport_title": "MLS",
    "commence_time": "2026-10-14T23:30:00Z",
    "home_team": "CF Montreal",
    "away_team": "Atlanta United FC",
    "bookmakers": [
        {
            "key": "bovada",
            "title": "Bovada",
            "last_update": "2026-10-14T11:54:00Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2026-10-14T11:54:00Z",
                    "outcomes": [
                        {"name": "Atlanta United FC", "price": 178},
                        {"name": "CF Montreal", "price": 132},
                        {"name": "Draw", "price": 265}
                    ]
                },
                {
                    "key": "spreads",
                    "last_update": "2026-10-14T11:54:00Z",
                    "outcomes": [
                        {"name": "Atlanta United FC", "price": -125, "point": 0.25},
                        {"name": "CF Montreal", "price": 105, "point": -0.25}
                    ]
                },
                {
                    "key": "totals",
                    "last_update": "2026-10-14T11:54:00Z",
                    "outcomes": [
                        {"name": "Over", "price": -112, "point": 3},
                        {"name": "Under", "price": -108, "point": 3}
                    ]
                }
            ]
        },
        ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits

See the API documentation for details.

Other Sports ​

See the full list of sports covered by The Odds API.

Stay Updated ​

Follow us on X.com or Bluesky to stay updated on new sports, bookmakers, markets and features.