Searching by match ID

GET /tennis/v2/extend/api/historical-odds/movements?match_id=32703-29462-17157-5

Providing only match_id returns the available movements across all markets, bookmakers, and lines for that match.

There is no default year restriction for this search. If supplied, player1, player2, and year do not affect match selection.

The response is grouped as:

result → market → bookmaker → movement records

Searching by player names

GET /tennis/v2/extend/api/historical-odds/movements?player1=Gijs%20Brouwer&player2=Michael%20Geerts&year=2021

When match_id is omitted:

• Both player names are required.
• Matching ignores capitalization and leading/trailing spaces in the supplied names.
• Either player order is accepted.
• Names must match the stored full names; partial-name searches are not supported.
• Omitting year searches the current year.
• Multiple matches are separated by their historical match identifiers.

The response gains one additional grouping level:

result → match_id → market → bookmaker → movement records

The year is based on the odds’ recorded timestamp, using January 1 at 00:00:00 UTC inclusive through the following January 1 exclusive. It is not based on the database import date.

Filtering markets and bookmakers

Request one market and bookmaker:

GET /tennis/v2/extend/api/historical-odds/movements?match_id=32703-29462-17157-5&market_id=2&bookmaker_id=20

How movements are detected

Quotes are compared within each match, market, bookmaker, and line:

A movement requires a change in either price, not necessarily both.

Returning to an earlier price still counts as a movement. Numeric formatting differences, such as "1.90" and "1.900", do not.

previousOd1, previousOd2, and previousAddTime refer to the immediately preceding stored quote in the same series. That quote may have been excluded from the response because its prices were unchanged.

Initial quotes

By default:

include_initial=true

The first recorded quote for each series is returned with:

{
  "previousOd1": null,
  "previousOd2": null,
  "previousAddTime": null,
  "isInitial": true
}

To return changes only:

GET /tennis/v2/extend/api/historical-odds/movements?match_id=32703-29462-17157-5&include_initial=false

An initial quote means the first quote available in the stored data. It is not necessarily the bookmaker’s actual opening price.

Time-range filtering

GET /tennis/v2/extend/api/historical-odds/movements?match_id=32703-29462-17157-5&from=1624528991&to=1624532591

Both bounds are inclusive:

from ≤ addTime ≤ to

Change detection uses preceding quotes before applying the lower time bound. Therefore:

• A movement inside the range can reference a previous quote outside the range.
• The first quote inside the range is not automatically treated as an initial quote.
• An initial quote is returned only if its own timestamp falls inside the range.
• This endpoint does not add a snapshot of the price already in effect at from.

For player-name searches, the time range also intersects with the selected year.

This endpoint summarizes historical odds separately for each match, market, bookmaker, and line.

• First: the earliest recorded quote.
• Last: the latest recorded quote.
• Minimum odds: the lowest numeric price recorded for each outcome.
• Maximum odds: the highest numeric price recorded for each outcome.
• Record count: the number of stored quotes, including unchanged prices.

First and last recorded quotes are not necessarily the bookmaker’s actual opening and closing prices.

Searching by match ID

GET /tennis/v2/extend/api/historical-odds/summary?match_id=32703-29462-17157-5

Providing only match_id returns summaries for all available markets, bookmakers, and lines for that match.

There is no default year restriction. When match_id is supplied, player1, player2, and year do not affect match selection.

The response is grouped as:

result → market → bookmaker → line summaries[]

Filtering markets and bookmakers

Request one market and bookmaker:

GET /tennis/v2/extend/api/historical-odds/summary?match_id=32703-29462-17157-5&market_id=2&bookmaker_id=20

Time-range filtering

GET /tennis/v2/extend/api/historical-odds/summary?match_id=32703-29462-17157-5&from=1624528991&to=1624532591

from and to are Unix timestamps in seconds. Both bounds are inclusive:

from ≤ addTime ≤ to

The selected range applies to every calculation:

• first is the earliest quote inside the range.
• last is the latest quote inside the range.
• minOdds and maxOdds use only prices inside the range.
• recordCount counts only records inside the range.

For player-name searches, the time range also intersects with the selected year.

Understanding the calculations

Suppose one bookmaker has these quotes for the same market and line:

• First: 1.87 / 1.87 at 10:00.
• Last: 1.90 / 1.84 at 10:03.
• Minimum: od1 = 1.87; od2 = 1.80.
• Maximum: od1 = 1.95; od2 = 1.87.
• Record count: 4, including the unchanged quote at 10:01.

Both prices in first come from the same first record. Both prices in last come from the same last record.

Minimum and maximum prices are calculated independently for each outcome, so their two prices may come from different timestamps.

When only one record exists, the first and last quotes are identical. If timestamps are equal, the database record ID determines their order.

Reading a line summary

Each bookmaker’s array contains objects with this structure:

{
  "line": "-0.5/+0.5",
  "recordCount": 4,
  "first": {
    "od1": "1.87",
    "od2": "1.87",
    "addTime": 1624528800
  },
  "last": {
    "od1": "1.90",
    "od2": "1.84",
    "addTime": 1624528980
  },
  "minOdds": {
    "od1": "1.87",
    "od2": "1.80"
  },
  "maxOdds": {
    "od1": "1.95",
    "od2": "1.87"
  }
}

Prices are returned as strings or null. addTime is a Unix timestamp in seconds. The line may be empty for markets where no line applies.

Empty results and errors

No matching records returns a successful response with an empty result:

{
  "success": true,
  "match_id": "32703-29462-17157-5",
  "result": {}
}

HTTP 400 is returned when:

• Neither match_id nor both player names are provided.
• A parameter has an invalid type or value.
• from is greater than to.

Records without timestamps are excluded. Null or nonnumeric prices are excluded from minimum and maximum calculations, but their timestamped records still contribute to the record count.

If an outcome has no numeric prices, its minimum and maximum are null.

There is no pagination. All matching timestamped records contribute to the summaries; individual historical quotes are not returned.