After the WebSockets connection has been made and the connection authorised, you will first receive the initial packet:Field NameTypeDescription
Field Name
Type
Description
teamAPlayer1
string
The name of the first player in the team
teamAPlayer2
string
(Doubles only) The name of the second player in the team . referred to as team A.
teamBPlayer1
string
The name of the first player in the team referred to as team B.
teamBPlayer2
string
(Doubles only) The name of the second player in the team . . . referred to as team B.
Every subsequent packet will be a Combined Statistics object with the following format:
Field Name
Type
Description
match
object
The overall statistics for the match
set1
object
The statistics for set 1
set2
object
The statistics for set 2 (if set has started)
set3
object
The statistics for set 3 (if set has started)
set4
object
The statistics for set 4 (if set has started)
set5
object
The statistics for set 5 (if set has started)
Only Grand Slam matches go up to five sets for men and three for women. Usually, the first player to win six games wins a set. Click here for more specific tournament scenarios.
Field Name
Type
Description
teamA
object
The team statistics for team A serving
teamB
object
The team statistics for team B serving
Field Name
Type
Description
aces
int
The number of aces served by the player
totalServes
int
The total number of serves by the player
1stServe
int
The total number of successful (non-fault) 1st serves
1stServe%
double
The percentage of successful 1st serves
1stServePointsWon
int
The number of points won on a 1st serve
1stServePointsWon%
double
The percentage of points won on a 1st serve
2ndServes
int
The total number of successful (non-fault) 2nd serves
2ndServePointsWon
int
The number of points won on a 2nd serve
2ndServePointsWon%
double
The percentage of points won on a 2nd serve
breakPointsPlayed
int
The number of break points against the player’s serve
breakPointsSaved
int
The number of break points saved
faults
int
The number of faults served by the player
doubleFaults
int
The number of double faults served by the player
This stream summarises the scoring events from a tennis match. E.g. number of aces served, 1st serve percentage, break points, e.t.c... If you connect to the stream when the match has already started, you will receive only the latest statistics. Unlike the events stream, there is no facility to replay the statistics from the start.
This endpoint takes no parameters.
New URL: wss://dde-streams.data.imgarena.com/tennis/events/{event-id}/statistics
Old URL: wss://dde-streams.imggaming.com/tennis/events/{event-id}/statistics
N.B. – Please use event ID “2022-0784-QS010” to return you the sample data. The authentication token provided will be required to make a connection to this websocket endpoint.
Connect to SSL websocket address
Send JSON packet containing API token
Format to send API token:
{"authToken": "authentication token"}
Receive response indicating that connection is authorised (or a response indicating why the connection cannot be made)
Receive data packets
Once you have the API token, any further data that you send over the connection will be ignored.
Please find a breakdown of the full schema for /statistics endpoint