# MMA/UFC Odds API

The Odds API covers MMA/UFC odds for live and upcoming fights in a simple JSON API.

Not a developer? Current MMA/UFC 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

  • MMA/UFC odds are covered for live and upcoming fights.

  • Fight winner is covered for several bookmakers. See the full list of bookmakers. Limited coverage of total rounds odds are also available from some bookmakers.

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

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

  • Historical MMA/UFC odds data is available from June 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 MMA/UFC Odds

Featured markets (fight winner and totals) can be queried using the odds endpoint.

Parameters

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

  • sport   In this case mma_mixed_martial_arts
  • regions   Regions of bookmakers to return, for example, us, uk and eu
  • markets   For example, h2h for fight winner
  • apiKey   Get a free API key
  • oddsFormat   This parameter is optional, and can be used to return odds in American format (oddsFormat=american). By default, odds will return in decimal format.

See the documentation for more options

Example API Request

https://api.the-odds-api.com/v4/sports/mma_mixed_martial_arts/odds?regions=us,uk,eu&markets=h2h&apiKey=YOUR_API_KEY

Example API Response

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

[{
    "id": "e46e328f688ff096aca6e5bb4ac96bbc",
    "sport_key": "mma_mixed_martial_arts",
    "sport_title": "MMA",
    "commence_time": "2025-12-31T22:59:00Z",
    "home_team": "Max Holloway",
    "away_team": "Alex Volkanovski",
    "bookmakers": [
      {
        "key": "unibet_uk",
        "title": "Unibet",
        "last_update": "2025-02-25T23:07:18Z",
        "markets": [
          {
            "key": "h2h",
            "last_update": "2025-02-25T23:07:18Z",
            "outcomes": [
              // to see odds in American format, add &oddsFormat=american to the request URL
              {"name": "Alex Volkanovski", "price": 1.6},
              {"name": "Max Holloway", "price": 2.3}
            ]
          }
        ]
      },
      ...

The usage cost of the API call in this example is

usage cost = [number of markets] x [number of regions] = 1 x 3 = 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.