Overview
The Tennis Predictions feed provides detailed fixture and live-match information for tennis matches, including game score, set score, current score, point-in-match state, and predictive elements. Prediction outputs include the probability of winning the current game, current set, match, next point, and specific game, set, and match score outcomes.
Problem Statement & Use Cases
This API solves the business problem of turning live tennis scoring and point-state data into structured predictive signals that can be consumed by applications, analytics pipelines, and in-play products. It provides a fixture-scoped feed for modeling how each point changes the likelihood of a player winning the next point, current game, current set, and match.
| Use Case |
Description |
| Live probability widgets |
Display point-by-point probabilities for match, set, game, and point outcomes in fan-facing match centers. |
| In-play analytics |
Track leverage, clutch points, momentum, and probability swings as each point is played. |
| Trading and market monitoring |
Compare live match win probability with market odds and monitor prediction-to-odds differences. |
| Historical model evaluation |
Query predictions by point number or point ranges to evaluate model behavior and point-level probability movement. |
Compliance & Guidelines
Authentication and API Security
Use the Stats Perform API Overview, Authentication Guide, and FAQs for API security, best-practice request logic, and OAuth authentication.
Polling Frequency
| Match State |
Polling Frequency |
| Live |
One call per fixture UUID every 30 seconds. |
| Post-match |
Once per hour. |
Request Formatting Rules
All URLs are case-sensitive. Requests must use the correct path casing, query parameter names, operators, and required values or the API returns an error.
| Rule |
Requirement |
| Query string start |
Begin the query parameter string with ? immediately after the feed name or fixture UUID path segment. |
| Parameter separator |
Separate query parameters with &. |
| Multiple values: AND |
Use & for multiple values where the API treats them as AND. |
| Multiple values: OR |
Use , only where the parameter explicitly supports OR-style multiple values. |
| NOT operator |
Use ! only where the parameter explicitly supports negation. |
| Underscore-prefixed parameters |
Preserve the required _ prefix for parameters such as _fmt and _clbk. |
| Placeholder braces |
Remove placeholder curly braces {} from production calls. They are documentation placeholders only. |
JSONP Requirements
If _fmt=jsonp is used, the request must also include _clbk with a fixed callback function name.
| Constraint |
Requirement |
Reason |
| JSONP callback |
Use _fmt=jsonp together with _clbk. |
JSONP responses require a callback wrapper function. |
| Fixed callback name |
Use a fixed callback value whenever possible. |
Random callback names can reduce cacheability and violate API best-practice logic. |
| JavaScript frameworks |
Override framework-generated random callback names, including defaults from common frameworks such as jQuery. |
Some frameworks generate random JSONP callback names unless explicitly configured. |
Endpoints
Base URL
https://api.statsperform.com
Feed Resource
/sdapi/v1/tennisdata/predictions/matchpredictionsdetail
Get Detailed Match Predictions by Fixture UUID
GET /sdapi/v1/tennisdata/predictions/matchpredictionsdetail/{fixtureUuid}?{queryParameters}
| Usage |
Feed |
Get predictions on match information and score details from the /matchpredictionsdetail feed by fixture UUID path parameter/resource ID. |
sdapi/v1/tennisdata/predictions/matchpredictionsdetail/{fixtureUuid}?{queryParameters} |
Query Parameters
This feed uses Global query parameters and the feed-specific query parameters listed below.
The /matchpredictionsdetail feed must be queried by a specific fixture UUID.
Feed-Specific Query Parameters
| Query Parameter |
Description |
Accepted Values / Format |
Example Request |
fixtureUuid |
Get detailed information about one fixture by passing the fixture UUID as a path parameter/resource ID in the URL. |
Fixture UUID |
GET https://api.statsperform.com/sdapi/v1/tennisdata/predictions/matchpredictionsdetail/{fixtureUuid}?_fmt={dataFormat} |
point |
Get detailed information about one fixture and a point by passing the point parameter with the fixture UUID path parameter. |
0, 1-n, omitted, or n,m |
GET https://api.statsperform.com/sdapi/v1/tennisdata/predictions/matchpredictionsdetail/{fixtureUuid}?point={pointInMatch}&_fmt={dataFormat} |
Point Parameter Semantics
| Value Pattern |
Behavior |
1-n |
Delivers predictions to the requested point, where n is any integer. |
0 |
Delivers all pre-match predictions. |
| Omitted |
Response contains the latest point including predictions. |
n,m |
Delivers all points including predictions in the inclusive range from n to m, where n and m are integers. |
Output Schema
The response fields are documented using XML element names. JSON responses contain similar fields, but XML-only wrapper nodes may be omitted or represented differently.
<matches> (XML only)
| Property |
Value |
| Nesting |
matches |
| Description |
Required/Optional. Root element of the fields related to matches (XML only) |
| Attributes |
None |
| Notes |
Not present in JSON feed response, where the root element is match |
<match>
| Property |
Value |
| Nesting |
matches/match |
| Description |
Required. Root element of the fields related to the match |
| Attributes |
None |
`<match
Info>`
| Property |
Value |
| Nesting |
matches/match/matchInfo |
| Description |
Required. Root element of the fields related to match information |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) for the fixture/match |
String (Alphanumeric - UUID) |
officialStartDate |
Yes |
The official start date and time of the fixture/match (UTC) |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
actualStartDate |
Yes |
The actual start date and time (UTC) of the match/fixture - for example, in the event of it being delayed or rescheduled, the actual start date/time will differ to the official start date/time |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
coverageLevel |
Yes |
The level of detail in which the match is covered. Possible values: • 0 = Only final set or game-by-game scores available • 1 = Only Point by Point scores available • 2 = Point by Point scores available along with match events (ATP) • 3 = Point by Point scores available along with match events (WTA) |
Integer - for example: 3 |
drawPosition |
No |
The position of the match within the tournament draw used for creating a tournament tree |
Integer |
lastUpdated |
Yes |
The UTC date and time (timestamp) of when the information/record was last updated |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
<description>
| Property |
Value |
| Nesting |
matches/match/matchInfo/description |
| Description |
Required. Root element of the fields related to the match description. Value: String giving the match description |
| Attributes |
None |
<tournament>
| Property |
Value |
| Nesting |
matches/match/matchInfo/tournament |
| Description |
Required. Root element of the fields related to the tournament |
| Notes |
It is 'Mixed' if a doubles pairing comprises a male player and a female player |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) of the tournament |
String (Alphanumeric - UUID) |
name |
Yes |
Name of the tournament |
String |
startDate |
Yes |
The start date (UTC) of the tournament |
Date - in the format: YYYY-MM-DDZ |
endDate |
Yes |
The end date (UTC) of the tournament |
Date - in the format: YYYY-MM-DDZ |
type |
Yes |
The type of tournament, for example a 'Grand Slam' |
String |
drawSize |
Yes |
The number of players in the main draw of the tournament before elimination/matches begin |
Integer |
matchType |
Yes |
The type of match - for example 'Single' (one player vs one player), 'Double' (two players in a duo vs two players in a duo), or 'Mix' (a 'Double' match but with mixed genders), 'national_team' (played between national teams) |
String |
status |
No |
The status of the tournament - one of the following: Scheduled | In Progress | Completed | Postponed | Suspended | Cancelled | Break Scheduled - Tournament status before a tournament starts In Progress - Tournament status after the first match starts Completed - Status when the last match of the tourney is over Postponed - Status is used for tourneys that have been put on hold but not officially Cancelled Suspended - Status is used for a tourney where a delay (rain) has happened in all active matches Cancelled - Status is used for tourneys that remain in the schedule but are 100% not to be played Break - Status is used when all active matches Suspendedfor the day due to delay (rain) and a new schedule is released for next day |
String |
cityName |
No |
Name of the City the tournament is played |
String |
gender |
Yes |
The genders of the players in the match - one of the following: Men | Women | Mixed |
String |
active |
Yes |
Confirms if a tournament is active/current or not |
String - Yes (current) | No (not current) |
totalPrizeMoney |
No |
The total amount of prize money available for a tournament |
Integer |
totalPrizeCurrency |
Yes |
The currency of the prize money |
String |
winnerNationalTeamId |
Yes |
Unique ID (UUID) of the winner team |
String (Alphanumeric - UUID) |
winnerNationalTeam |
Yes |
The name of the winner national team |
String |
winnerPrizeMoney |
Yes |
The amount of prize money awarded to the winner/s of a tournament |
Integer |
winnerPrizeCurrency |
No |
The currency of prize money awarded to the winner/s of a tournament |
String |
lastUpdated |
Yes |
The UTC time when the tournament record was last updated |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
<tours>
| Property |
Value |
| Nesting |
matches/match/matchInfo/tours |
| Description |
Required. Root element of the fields related to tours |
| Attributes |
None |
<tour>
| Property |
Value |
| Nesting |
matches/match/matchInfo/tours/tour |
| Description |
Required. Root element of the fields related to the tour associated with the tournament. Value (XML only): String giving the name of the tour |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) of the tour |
String (Alphanumeric - UUID) |
name (JSON only) |
Yes |
Name of the tour |
String |
<competition>
| Property |
Value |
| Nesting |
matches/match/matchInfo/competition |
| Description |
Required. Root element of the related fields for the competition associated with the tournament |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) of the competition |
String (Alphanumeric - UUID) |
name |
Yes |
Name of the competition |
String |
areaId |
Yes |
Unique ID (UUID) of the area that the competition takes place in |
String (Alphanumeric - UUID) |
areaName |
Yes |
Name of the area that the competition takes place in |
String |
court |
Yes |
Type of court for the competition - for example: Grass |
String |
lastUpdated |
Yes |
The UTC date and time (timestamp) of when the information/record was last updated |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
`<tour
Calendars>`
| Property |
Value |
| Nesting |
matches/match/matchInfo/tourCalendars |
| Description |
Required. Root element of the fields related to tour calendars |
| Attributes |
None |
`<tour
Calendar>`
| Property |
Value |
| Nesting |
matches/match/matchInfo/tourCalendars/tourCalendar |
| Description |
Required. Root element of the fields related to the tour calendar. Value (XML only): String giving the tour calendar name |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) of the tour calendar |
String (Alphanumeric - UUID) |
startDate |
Yes |
The start date (UTC) of the tour calendar |
Date - in the format: YYYY-MM-DDZ |
endDate |
Yes |
The end date (UTC) of the tournament calendar |
Date - in the format: YYYY-MM-DDZ |
name (JSON only) |
Yes |
Name of the tour calendar |
String |
<round>
| Property |
Value |
| Nesting |
matches/match/matchInfo/round |
| Description |
Required. Root element of the fields related to the round |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) of the round |
String (Alphanumeric - UUID) |
formatId |
Yes |
Unique format ID (UUID) of the round |
String (Alphanumeric - UUID) |
title |
Yes |
Title of the round |
String |
startDate |
Yes |
The start date (UTC) of the round |
Date - in the format: YYYY-MM-DDZ |
endDate |
Yes |
The end date (UTC) of the round |
Date - in the format: YYYY-MM-DDZ |
scoringSystem |
Yes |
The scoring system of the round |
String |
group |
Yes |
Group for the round |
Integer |
ties |
Yes |
Ties for the round |
Integer |
orderMethod |
Yes |
The order method of the round |
Integer |
prizeMoney |
No |
The prize money available for the round |
Integer |
prizeCurrency |
Yes |
The currency of the prize money for the round |
String |
lastUpdated |
Yes |
The UTC time when the round record was last updated |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
<contestants>
| Property |
Value |
| Nesting |
matches/match/matchInfo/contestants |
| Description |
Required. Root element of the fields related to the contestants |
| Attributes |
None |
<contestant>
| Property |
Value |
| Nesting |
matches/match/matchInfo/contestants/contestant |
| Description |
Required. Root element of the fields related to a contestant |
| Attribute |
Required |
Description |
Values |
contestantId |
Yes |
Unique ID (UUID) of the contestant Will be replaced by id in case of singles |
String (Alphanumeric - UUID) |
playerId |
Yes |
Unique ID (UUID) of the players in the doubles team. Will not be present in case of singles |
String (Alphanumeric - UUID) |
name |
Yes |
The name of the contestant |
String |
position |
Yes |
Indicates the position of the contestant for the scoring - for example a or b |
String |
seed |
No |
The seed number of the contestant - for example 7 |
Integer |
seedQualification (JSON only) |
No |
The seed qualification number of the contestant - for example 2 |
Integer |
<country>
| Property |
Value |
| Nesting |
matches/match/matchInfo/contestants/contestant/country |
| Description |
Required. Root element of the fields related to the country of the contestant. Value (XML only): String giving the country name |
| Attribute |
Required |
Description |
Values |
id |
Yes |
Unique ID (UUID) of the country the contestant is based in |
String (Alphanumeric - UUID) |
name (JSON only) |
Yes |
Name of the country |
String |
`<live
Data>`
| Property |
Value |
| Nesting |
matches/match/liveData |
| Description |
Optional. Root element of the fields related to live data |
| Attributes |
None |
`<match
Details>`
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails |
| Description |
Optional. Root element of the fields related to match details |
| Notes |
This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'.
This is only returned if the winner of the match is known (with a match status of "Played")
Available only for matches with coverageLevel 1, 2 and 3. |
| Attribute |
Required |
Description |
Values |
matchStatus |
Yes |
The status of the match. |
String - one of the following: Played | Cancelled | Fixture | Playing | Postponed | Retired |Suspended | Walkover | Bye| Awarded |
matchSet |
Yes |
Indicates the current set - for example, if 3 sets have been played so far, the value will be '3' and three sets (set1, set2, set3) will be nested in the scores element |
Integer |
winner |
No |
The winner of the match - indicated by position given to the contestant in the contestants node, either a or b. |
String |
firstServerId |
Yes |
Unique ID (UUID) of the player who served first in the match. |
String |
matchMinutes |
Yes |
The total duration of the match from the start till the end in minutes. |
Integer |
matchEndTime |
Yes |
The date and time (in UTC)when the final point of the match was completed. |
Date/Time - in the format: YYYY-MM-DDThh:mm:ssZ |
<scores>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores |
| Description |
Optional. Root element of the fields related to the scores |
| Attributes |
None |
| Notes |
This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'. |
<set1>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores/set1 |
| Description |
Optional. Root element of the fields related to the first set (set 1) of a match |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The number of games won by contestant A - holds position="a" (nested in contestants/contestant) in the match |
Integer |
b |
Yes |
The number of games won by contestant B - holds position="b" (nested in contestants/contestant) in the match |
Integer |
tiebreakA |
No |
- only returned when there is a tie break in the set. Indicates the number of points won by contestant A in the tie break |
Integer |
tiebreakB |
No |
- only returned when there is a tie break in the set. Indicates the number of points won by contestant B in the tie break |
Integer |
<set2>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores/set2 |
| Description |
Optional. Root element of the fields related to the second set (set 2) of a match |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The number of games won by contestant A - holds position="a" (nested in contestants/contestant) in the match |
Integer |
b |
Yes |
The number of games won by contestant B - holds position="b" (nested in contestants/contestant) in the match |
Integer |
tiebreakA |
No |
- only returned when there is a tie break in the set. Indicates the number of points won by contestant A in the tie break |
Integer |
tiebreakB |
No |
- only returned when there is a tie break in the set. Indicates the number of points won by contestant B in the tie break |
Integer |
<set3>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores/set3 |
| Description |
Optional. Root element of the fields related to the third set (set 3) of a match |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The number of games won by contestant A - holds position="a" (nested in contestants/contestant) in the match |
Integer |
b |
Yes |
The number of games won by contestant B - holds position="b" (nested in contestants/contestant) in the match |
Integer |
<set4>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores/set4 |
| Description |
Optional. Root element of the fields related to the fourth set (set 4) of a match |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The number of games won by contestant A - holds position="a" (nested in contestants/contestant) in the match |
Integer |
b |
Yes |
The number of games won by contestant B - holds position="b" (nested in contestants/contestant) in the match |
Integer |
<set5>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores/set5 |
| Description |
Optional. Root element of the fields related to the fifth set (set 5) of a match |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The number of games won by contestant A - holds position="a" (nested in contestants/contestant) in the match |
Integer |
b |
Yes |
The number of games won by contestant B - holds position="b" (nested in contestants/contestant) in the match |
Integer |
<total>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/scores/total |
| Description |
Optional. Root element of the fields related to the total sets. This can also show the current set that is being played when the match is being covered 'live’ |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The number of sets won by contestant A - holds position "a" (nested in contestants/contestant) in the match. |
Integer |
b |
Yes |
The number of sets won by contestant B - holds position "b" (nested in contestants/contestant) in the match |
Integer |
`<game
State>`
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/gameState |
| Description |
Required. Root element of the fields related to the state of the game. |
| Attributes |
None |
<score>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/gameState/score |
| Description |
Optional. Root element of the fields related to score |
| Attribute |
Required |
Description |
Values |
a |
No |
The score of the contestant A in the match. |
Integer |
b |
No |
The score of the contestant A in the match. |
|
<server>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/gameState/server |
| Description |
Optional. Root element of the fields related to the server. |
`<tie
Break>`
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/gameState/tieBreak |
| Description |
Optional. Root element of the field related to the tiebreak in a match. |
`<match
Status>`
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/matchStatus |
| Description |
Optional. Root element of match that describes the status. |
| Notes |
A value of Awarded is used for matches that do not take place or when one of the contestants involved gets 'awarded' the match with an associated result. |
| Attribute |
Required |
Description |
Values |
matchStatus |
Yes |
The status of the match - one of the following: Fixture | Playing | Played | Cancelled | Postponed | Suspended | Awarded | Bye |
String |
`<match
Set>`
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/matchSet |
| Description |
Optional. Root element of the field related to the number of sets played in a match. |
| Attribute |
Required |
Description |
Values |
matchSet |
Yes |
The number of sets played in a match. |
Integer |
<winner>
| Property |
Value |
| Nesting |
matches/match/liveData/matchDetails/gameState/winner |
| Description |
Optional. Root element of the field related to the winner in a match. |
| Attribute |
Required |
Description |
Values |
winner |
Yes |
The winner of the match - indicated by position given to the contestant. |
String |
<predictions>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions |
| Description |
Required. Root element of the fields related to the predictions in a game. |
| Attributes |
None |
<game_winner>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/game_winner |
| Description |
Optional. Root element of the field indicating the prediction for winning the game. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player 'a' winning the game. |
Integer |
b |
Yes |
Probability of player 'b' winning the game. |
Integer |
`<set
Score>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/setScore |
| Description |
Optional. Root element of the field related to the predicted score in the set, possible scores in the set and the likelihood of them being scored. |
| Attribute |
Required |
Description |
Values |
val_7-6 |
No |
Probability of this score in the set. |
Float |
val_6-7 |
No |
Probability of this score in the set. |
Float |
val_6-0 |
No |
Probability of this score in the set. |
Float |
val_0-6 |
No |
Probability of this score in the set. |
Float |
val_6-1 |
No |
Probability of this score in the set. |
Float |
val_1-6 |
No |
Probability of this score in the set. |
Float |
val_6-2 |
No |
Probability of this score in the set. |
Float |
val_2-6 |
No |
Probability of this score in the set. |
Float |
val_6-3 |
No |
Probability of this score in the set. |
Float |
val_3-6 |
No |
Probability of this score in the set. |
Float |
val_6-4 |
No |
Probability of this score in the set. |
Float |
val_4-6 |
No |
Probability of this score in the set. |
Float |
val_7-5 |
No |
Probability of this score in the set. |
Float |
val_5-7 |
No |
Probability of this score in the set. |
Float |
<pointwinner>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/pointWinner |
| Description |
Optional. Root element of the field related to the prediction of winning the next playerd point. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of winning the next played point by contestant A. |
Integer |
b |
Yes |
Probability of winning the next played point by contestant B. |
Integer |
<match_winner>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/match_Winner |
| Description |
Optional. Root element of the field related to the prediction for winning the match. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probalility for contestant A to win the match. |
Integer |
b |
Yes |
Probability for contestant B to win the match. |
Integer |
`<point
InMatch>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/pointInMatch |
| Description |
Optional. Root element of the field related to the number of points in the match, increased with each point played. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Indicates the number of point in match, increased with each point played. |
Integer |
`<score
Board>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/matchScore |
| Description |
Optional. Root element of the field related to the information displayed in the scoreboard. |
| Attribute |
Required |
Description |
Values |
server |
Yes |
The player who serves first in the game. |
String |
`<match
Score>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/matchScore |
| Description |
Optional. Root element of the field related to the predicted match score, possible scores in the match and the likelihood of them being scored. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Indicates the number of point in match, increased with each point played. |
Integer |
b |
Yes |
Probability for contestant B to win the match. |
Integer |
<tiebreak>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/tiebreak |
| Description |
Optional. Root element of the field related to the tiebreak information in the scoreboard. |
| Attribute |
Required |
Description |
Values |
server |
Yes |
The information aboutthe tiebreak displayed in the scoreboard. |
Integer |
`<game
Score>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/gameScore |
| Description |
Optional. Root element of the field related to the predicted score in the game, possible game scores and the likelihood of them being scored. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Indicates the number of point in match, increased with each point played. |
Integer |
b |
Yes |
Probability for contestant B to win the match. |
Integer |
`<set
Score>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/setScore |
| Description |
Optional. Root element of the field related to the score in a set. |
<set1>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/setScore/set1 |
| Description |
Optional. Root element of the field related to the set 1. |
<set2>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/scoreBoard/setScore/set2 |
| Description |
Optional. Root element of the field related to the set 2. |
<game_score>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/game_score |
| Description |
Optional. Root element of the field related to the score in the game. |
| Attribute |
Required |
Description |
Values |
val_6-7 |
No |
Probability of this score in the game. |
Float |
val_7-6 |
No |
Probability of this score in the game. |
Float |
val_4-0 |
No |
Probability of this score in the game. |
Float |
val_0-4 |
No |
Probability of this score in the game. |
Float |
val_4-1 |
No |
Probability of this score in the game. |
Float |
val_1-4 |
No |
Probability of this score in the game. |
Float |
val_4-2 |
No |
Probability of this score in the game. |
Float |
val_2-4 |
No |
Probability of this score in the game. |
Float |
val_4-3 |
No |
Probability of this score in the game. |
Float |
val_3-4 |
No |
Probability of this score in the game. |
Float |
val_0-7 |
No |
Probability of this score in the game. |
Float |
val_7-0 |
No |
Probability of this score in the game. |
Float |
val_1-7 |
No |
Probability of this score in the game. |
Float |
val_7-1 |
No |
Probability of this score in the game. |
Float |
val_2-7 |
No |
Probability of this score in the game. |
Float |
val_7-2 |
No |
Probability of this score in the game. |
Float |
val_3-7 |
No |
Probability of this score in the game. |
Float |
val_7-3 |
No |
Probability of this score in the game. |
Float |
val_4-7 |
No |
Probability of this score in the game. |
Float |
val_7-4 |
No |
Probability of this score in the game. |
Float |
val_5-7 |
No |
Probability of this score in the game. |
Float |
val_7-5 |
No |
Probability of this score in the game. |
Float |
<match_score>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/match_score |
| Description |
Optional. Root element of the field related to the score in a match. |
| Attribute |
Required |
Description |
Values |
val_2-0 |
Yes |
Probability of this score in the match. |
Integer |
val_0-2 |
Yes |
Probability of this score in the match. |
Integer |
val_2-1 |
Yes |
Probability of this score in the match. |
Integer |
val_1-2 |
Yes |
Probability of this score in the match. |
Integer |
<set_winner>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/set_winner |
| Description |
Optional. Root element of the field related to the prediction for winning the set. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
The prediction for winning the set by contestant A. |
Integer |
b |
Yes |
The prediction for winning the set by contestant B. |
Integer |
`<market
Data>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/marketData |
| Description |
Optional. Root element of the field related to market data. |
| Attributes |
None |
`<live
MatchWinProb>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/marketData/liveMatchWinProb |
| Description |
Optional. Root element of the field related to live match win probabilty related market data. |
| Attribute |
Required |
Description |
Values |
margin |
Yes |
The calculated margin placed on the bet by the betting provider. |
Float |
p2PredDiff |
No |
The difference between LWP and odds for Away(2) market. |
Float |
p2RawOdds |
No |
Raw odds for Away(2) market. |
Float |
p1100Odds |
No |
Normalized odds without margin for Home(1) market. |
Float |
p1RawOdds |
No |
Raw odds for Home(1) market. |
Float |
p2100Odds |
No |
Normalized odds without margin for Away (2) market. |
Float |
p1PredDiff |
No |
The difference between LWP and odds for Home(1) market. |
Float |
<metrics>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics |
| Description |
Optional. Root element of the field related to metrics. |
| Attributes |
None |
| Notes |
This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'. |
<clutch>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch |
| Description |
Optional. Root element of the field related to clutch. |
| Notes |
This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'. |
| Attribute |
Required |
Description |
Values |
clutchPoint |
Yes |
If the point is a clutchPoint (use isClutchpoint). |
Boolean. True|False |
isclutchPoint |
Yes |
If the point is a clutchPoint. |
Boolean. True|False |
isSetClutchpoint |
No |
If the point is a set clutchPoint – if the outcome of the point has a big effect on who will win the set. |
Boolean. True|False |
<point_winner_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ point_winner_a_wins_next_point |
| Description |
Optional. Root element of the fields related to point winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning next point if a wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning next point if a wins the current point. |
Float |
a_diff |
No |
Difference in Probability of player ‘a’ winning next point if a wins the current point to Probability of player ‘a’ winning next point at the current point. |
Float |
b_diff |
No |
Difference in Probability of player ‘b’ winning next point if a wins the current point to Probability of player ‘b’ winning next point at the current point. |
Float |
<point_winner_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ point_winner_b_wins_next_point |
| Description |
Optional. Root element of the fields related to point winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning next point if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning next point if b wins the current point. |
Float |
a_diff |
No |
Difference in Probability of player ‘a’ winning next point if ‘b’ wins the current point to Probability of player ‘a’ winning next point at the current point. |
Float |
b_diff |
No |
Difference in Probability of player ‘b’ winning next point if ‘b’ wins the current point to Probability of player ‘b’ winning next point at the current point. |
Float |
<set_winner_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ set_winner_a_wins_next_point |
| Description |
Optional. Root element of the fields related to set winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning current set if ‘a’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning current set if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between probability of player ‘a’ winning current set if ‘a’ wins the current point and actual probability. |
Float |
b_diff |
No |
Difference between probability of player ‘a’ winning current set if ‘a’ wins the current point and actual probability. |
Float |
<set_winner_b_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/ clutch/set_winner_b_wins_next_point |
| Description |
Optional. Root element of the fields related to set winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning current set if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning current set if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between probability of player ‘a’ winning current set if ‘b’ wins the current point and actual probability. |
Float |
b_diff |
No |
Difference between probability of player ‘b’ winning current set if ‘b’ wins the current point and actual probability. |
Float |
<game_winner_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ game_winner_a_wins_next_point |
| Description |
Optional. Root element of the fields related to game winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning current game if ‘a’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning current game if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ winning current game if ‘a’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ winning current game if ‘a’ wins the current point and his current probability. |
Float |
<game_winner_b_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ game_winner_b_wins_next_point |
| Description |
Optional. Root element of the fields related to game winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning current game if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning current game if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ winning current game if ‘b’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ winning current game if ‘b’ wins the current point and his current probability. |
Float |
<match_winner_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ match_winner_a_wins_next_point |
| Description |
Optional. Root element of the fields related to match winner. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning the match if ‘a’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning the match if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ winning current match if ‘a’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ winning current match if ‘a’ wins the current point and his current probability. |
Float |
<game_winner_b_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ match_winner_b_wins_next_point |
| Description |
Optional. Root element of the fields related to match winner |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning the match if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning the match if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ winning current match if ‘b’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ winning current match if ‘b’ wins the current point and his current probability. |
Float |
<win_tiebreak_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ win_tiebreak_a_wins_next_point |
| Description |
Optional. Root element of the fields related to win tiebreak |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning the tiebreak if ‘a’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning the tiebreak if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ winning the tiebreak if ‘a’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ winning the tiebreak if ‘a’ wins the current point and his current probability. |
Float |
<win_tiebreak_b_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ win_tiebreak_b_wins_next_point |
| Description |
Optional. Root element of the fields related to win tiebreak, |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ winning the tiebreak if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ winning the tiebreak if ‘b’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ winning the tiebreak if ‘b’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ winning the tiebreak if ‘b’ wins the current point and his current probability. |
Float |
<reach_tiebreak_a_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ reach_tiebreak_a_wins_next_point |
| Description |
Optional. Root element of the fields related to reach tiebreak. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ reaching the tiebreak if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ reaching the tiebreak if ‘a’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ reaching the tiebreak if ‘a’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ reaching the tiebreak if ‘a’ wins the current point and his current probability. |
Float |
<reach_tiebreak_b_wins_next_point>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/clutch/ reach_tiebreak_b_wins_next_point |
| Description |
Optional. Root element of the fields related to reach tiebreak. |
| Attribute |
Required |
Description |
Values |
a |
Yes |
Probability of player ‘a’ reaching the tiebreak if ‘b’ wins the current point. |
Float |
b |
Yes |
Probability of player ‘b’ reaching the tiebreak if ‘b’ wins the current point. |
Float |
a_diff |
No |
Difference between Probability of player ‘a’ reaching the tiebreak if ‘b’ wins the current point and his current probability. |
Float |
b_diff |
No |
Difference between Probability of player ‘b’ reaching the tiebreak if ‘b’ wins the current point and his current probability. |
Float |
<metrics>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics |
| Description |
Optional. Root element of the fields related to matrics. |
| Notes |
This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'. |
| Attribute |
Required |
Description |
Values |
leverage |
Yes |
The leverage of the current point. (How strongly the LWP will possibly change after the point). |
Float |
momentum |
Yes |
The momentum of the match. (Positive values indicate player ‘a’ has strong momentum. Negative values that player ‘b’ has momentum). |
Float |
excitement_rating |
Yes |
Rating between 0-10 if how exciting the point was based on L1 and L2 data. |
Float |
isClutchPoint |
Yes |
If the point is a clutch point for the match. |
Boolean. True|False |
isSetClutchPoint |
Yes |
If the point is a clutch point for the set. |
Boolean. True|False |
momentum_changed |
Yes |
If the momentum changed after the last point. |
Float |
set_momentum_changed |
Yes |
If the momentum of the set changed after the last point. |
Float |
set_leverage |
Yes |
The leverage of the point for the current set. |
Float |
set_momentum |
Yes |
The momentum at the current point for the current set. |
Float |
<metrics>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics |
| Description |
Optional. Root element of the fields related to matrics. |
| Notes |
This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'. |
<bigpointslast5>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/bigpointslast5 |
| Description |
Optional. Root element of the fields related to bigpointslast5. |
| Attribute |
Required |
Description |
Values |
PointInMatch |
Yes |
Number of point in the match. |
Integer |
HomeWonPercentage |
Yes |
Percentage of last 5 big points that home won. |
Float |
ForeignWon |
Yes |
Number of last five bigpoints foreign player ‘b’ won. |
Integer |
BigPointsPlayed |
No |
Number of big points played in the match. |
Integer |
ForeignWonPercentage |
No |
Percentage of last 5 bigpoints foreign player ‘b’ won. |
Float |
HomeWon |
No |
Number of last 5 big points home player won. |
Integer |
<momentum_stats>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/momentum_stats |
| Description |
Optional. Root element of the fields related to momentum stats. |
| Attribute |
Required |
Description |
Values |
momentum_min |
Yes |
Minimum value of momentum over the last 10 points. |
Float |
momentum_max |
Yes |
Maximum value of momentum over the last 10 points. |
Float |
momentum_changed |
No |
If the momentum changed in the current point. |
Boolean |
value |
No |
Current momentum value. |
Float |
player |
No |
Which player currently holds the momentum. |
Integer |
<bigpoints>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/metrics/bigpoints |
| Description |
Optional. Root element of the fields related to bigpoints. |
| Attribute |
Required |
Description |
Values |
PointInMatch |
Yes |
Current point in the match. |
Integer |
HomeWonPercentage |
Yes |
Percentage of big points won by home during the match. |
Float |
ForeignWon |
Yes |
Number of big points won by foreign player ‘b’ during the match. |
Integer |
BigPointsPlayed |
No |
Number of big points played during the match. |
Integer |
ForeignWonPercentage |
No |
Percentage of big points won by foreign player ‘b’ during the match. |
Float |
HomeWon |
No |
Number of big points won by home during the match. |
Integer |
`<point
Details>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/pointDetails |
| Description |
Optional. Root element of the field related to pointDetails. Note: This element is optional, it is returned once data is available - for example, if the match status is 'Playing' rather than 'Fixture' or 'Cancelled'. |
| Attribute |
Required |
Description |
Values |
shotType |
Yes |
The type of shot. |
Integer |
isVolley |
No |
Indicates whether the shot was a volley or not. |
String Possible vales: true/false |
isTeam1Serving |
Yes |
Team 1 serving or not (true or false) |
String |
isFirstServe |
Yes |
Wether it is a first serve (true or false) |
String |
zone |
Yes |
The zone of the team . |
String |
zoneTeamId |
Yes |
The zone team id of the team. |
String |
stroke |
No |
Indicated the type of stroke. |
Integer |
<pointtype>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/pointtype |
| Description |
Optional. Root element of the field related to pointtype. |
| Attribute |
Required |
Description |
Values |
pointtype |
No |
The type of point. earlyPoint, more than two points remaining in game setupPoint, two points remaining in game gamePoint, one point remaining in game, either game or break point |
String |
`<point
InSet>`
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/pointInSet |
| Description |
Optional. Root element of the field related to pointInSet. |
| Attribute |
Required |
Description |
Values |
pointInSet |
Yes |
The point in the set. |
Integer |
<timestamp>
| Property |
Value |
| Nesting |
matches/match/liveData/predictions/timestamp |
| Description |
Optional. Root element of the field related to the time the information was updated. |
| Attribute |
Required |
Description |
Values |
timestamp |
No |
The timestamp at a point (time includes hour-minute-seconds-milliseconds) of prediction-for example 1626443138643. |
Integer |
