tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsMatchesMatch prices
Matches

Match prices

MCP tool match_prices
GEThttps://api.tennisdatabaseapi.com/v1/matches/{id}/oddsEvery plan

Every bookmaker's closing and opening price for a match, and every market: games, sets, handicaps and correct score.

Free key includedLive includedArchive includedComplete included
Try itRuns against the live API with your key. Your key stays in this browser.API
GEThttps://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213/odds

1Parameters

NameInTypeWhat it is
idrequiredpathidAn id from another answer, such as mt_ and 8 characters. Ids are our own and never change.

Anything else in the address answers 422 unknown_parameter, with the list of parameters this endpoint takes.

2Request

curl -H "Authorization: Bearer $TDA_KEY" \
  "https://api.tennisdatabaseapi.com/v1/matches/mt_9e5aq213/odds"

The code follows the form in Try it, with your key in it once you have entered one. Without a key it reads $TDA_KEY.

3Answer

{
  "data": {
    "id": "mt_9e5aq213",
    "date": "2026-09-13",
    "tournament": { "id": "tn_1d50xrzv", "name": "US Open" },
    "round": "final",
    "winner": { "id": "pl_f560sfd7", "name": "Zverev A.", "country": "Germany" },
    "loser": { "id": "pl_3vde2gfg", "name": "Shelton B.", "country": "USA" },
    "score": "6-3 7-6(2) 5-7 6-2",
    "odds": {
      "closing": { "winner": 1.67, "loser": 2.2 },
      "bookmakers": {
        "10bet": {
          "winner": 1.67,
          "loser": 2.15,
          "opened": { "winner": 1.65, "loser": null }
        },
        "1xbet": {
          "winner": 1.59,
          "loser": 2.38,
          "opened": { "winner": 1.72, "loser": 2.31 }
        },
        "bet365": {
          "winner": 1.67,
          "loser": 2.3,
          "opened": { "winner": 1.7, "loser": 2.25 }
        },
        "bet_at_home": {
          "winner": 1.68,
          "loser": 2.2,
          "opened": { "winner": 1.65, "loser": null }
        },
        "betfair": {
          "winner": 1.67,
          "loser": 2.33,
          "opened": { "winner": 1.63, "loser": 2.27 }
        },
        "betsson": {
          "winner": 1.68,
          "loser": 2.13,
          "opened": { "winner": 1.65, "loser": 2.19 }
        },
        "betvictor": {
          "winner": 1.62,
          "loser": 2.25,
          "opened": { "winner": 1.67, "loser": 2.2 }
        },
        "betway": { "winner": 1.65, "loser": 2.3 },
        "bwin": {
          "winner": 1.7,
          "loser": 2.2,
          "opened": { "winner": 1.65, "loser": 2.3 }
        },
        "coral": {
          "winner": 1.65,
          "loser": 2.15,
          "opened": { "winner": 1.6, "loser": 2.2 }
        },
        "exchange": { "winner": 1.72, "loser": 2.36 },
        "interwetten": {
          "winner": 1.63,
          "loser": 2.25,
          "opened": { "winner": 1.65, "loser": 2.2 }
        },
        "ladbrokes": {
          "winner": 1.65,
          "loser": 2.15,
          "opened": { "winner": 1.6, "loser": 2.2 }
        },
        "market_average": { "winner": 1.67, "loser": 2.2 },
        "market_best": { "winner": 1.7, "loser": 2.3 },
        "market_consensus": { "winner": 1.66, "loser": 2.24 },
        "pinnacle": {
          "winner": 1.71,
          "loser": 2.27,
          "opened": { "winner": 1.67, "loser": 2.33 }
        },
        "unibet": {
          "winner": 1.62,
          "loser": 2.35,
          "opened": { "winner": 1.68, "loser": 2.2 }
        },
        "william_hill": { "winner": 1.67, "loser": 2.2 }
      },
      "markets": {
        "correct_score": [
          { "score": "0:3", "bookmaker": "10bet", "price": 6.5 },
          { "score": "0:3", "bookmaker": "bet365", "price": 7 },
          { "score": "0:3", "bookmaker": "bet_at_home", "price": 6 },
          "..."
        ],
        "handicap_games": [
          {
            "line": -5.5,
            "bookmaker": "1xbet",
            "winner": 4.4,
            "loser": 1.21,
            "opened": { "winner": 4.05, "loser": 1.23 }
          },
          {
            "line": -5.5,
            "bookmaker": "bet_at_home",
            "winner": 4,
            "loser": 1.23,
            "opened": { "winner": 3.95, "loser": 1.2 }
          },
          {
            "line": -5.5,
            "bookmaker": "interwetten",
            "winner": 4,
            "loser": 1.2,
            "opened": { "winner": 3.8, "loser": 1.22 }
          },
          "..."
        ],
        "handicap_sets": [
          {
            "line": -2.5,
            "bookmaker": "10bet",
            "winner": 4.33,
            "loser": 1.18,
            "opened": { "winner": 4, "loser": 1.2 }
          },
          {
            "line": -2.5,
            "bookmaker": "1xbet",
            "winner": 4.3,
            "loser": 1.21,
            "opened": { "winner": 4.2, "loser": 1.22 }
          },
          {
            "line": -2.5,
            "bookmaker": "bet_at_home",
            "winner": 4.3,
            "loser": 1.18,
            "opened": { "winner": 4.1, "loser": 1.2 }
          },
          "..."
        ],
        "total_games": [
          { "line": 34.5, "bookmaker": "unibet", "over": 1.25, "under": 3.8 },
          {
            "line": 35.5,
            "bookmaker": "bet_at_home",
            "over": 1.35,
            "under": 3,
            "opened": { "over": null, "under": 2.95 }
          },
          { "line": 35.5, "bookmaker": "market_average", "over": 1.34, "under": 3.13 },
          "..."
        ],
        "total_sets": [
          {
            "line": 3.5,
            "bookmaker": "bet_at_home",
            "over": 1.4,
            "under": 2.8,
            "opened": { "over": null, "under": 2.7 }
          },
          { "line": 3.5, "bookmaker": "betsson", "over": 1.4, "under": 2.75 },
          {
            "line": 3.5,
            "bookmaker": "betway",
            "over": 1.36,
            "under": 3,
            "opened": { "over": 1.4, "under": 2.7 }
          },
          "..."
        ]
      }
    }
  },
  "meta": {}
}

Real answers from the API, made 2026-11-18. Long lists are cut to three items here.

4Fields

FieldTypeWhat it holds
id, date, tournament, round, winner, loser, scoremixedThe match in short
odds.closingobjectThe market's closing prices for the winner and the loser, decimal
odds.bookmakersarrayEach bookmaker's closing price, with opened where the opening price is known
odds.marketsobjecttotal_games, total_sets, handicap_games, handicap_sets, correct_score, each line by bookmaker

5Errors

401unauthorizedNo key, or a key that is unknown or revoked.
404not_foundNo such id.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).