tennisdatabaseAPI

Tennis API documentation

Ctrl K
DocsBetting marketsBookmaker margins
Betting markets

Bookmaker margins

MCP tool bookmaker_margins
GEThttps://api.tennisdatabaseapi.com/v1/markets/margins

Each bookmaker's average margin on its closing prices since the start of last year.

Free key not 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/markets/margins

1Parameters

None. Anything in the address answers 422 unknown_parameter.

2Request

curl -H "Authorization: Bearer $TDA_KEY" \
  "https://api.tennisdatabaseapi.com/v1/markets/margins"

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": [
    { "bookmaker": "Exchange", "matches": 6180, "average_margin_pct": 0.71 },
    { "bookmaker": "Best price", "matches": 9885, "average_margin_pct": 2.12 },
    { "bookmaker": "Pinnacle", "matches": 80259, "average_margin_pct": 4.88 },
    "..."
  ],
  "meta": {
    "since": "2025-01-01",
    "counted_at": "2026-11-18 03:47:34",
    "note": "The margin is the sum of the two closing prices' implied chances, less one: the lower, the better the price."
  }
}

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

4Fields

FieldTypeWhat it holds
bookmaker, matches, average_margin_pctmixedEach bookmaker, the matches priced and the average margin, lowest first

5Errors

401unauthorizedNo key, or a key that is unknown or revoked.
403upgrade_requiredThe free key: this endpoint is on the Live plan and above.
422unknown_parameterA parameter this endpoint does not take.
429rate_limitedToo many calls this minute, or the allowance used (quota_exceeded).