Live Match Statistics - Box Score
This endpoint is a live match websocket endpoint that returns the full set up of player & team box score statistics and by period.
The authentication token provided will be required to make a connection to this websocket endpoint.
Once you have the API token, any further data that you send over the connection will be ignored.
N.B – This endpoint sends heartbeats in-between data packets to let you know that it is still connected.
This endpoint currently takes no request parameters
Endpoint URL
wss://dde-streams.data.imgarena.com/media/basketball/fixtures/{fixtureId}/statistics
Polling limits
IMG Arena monitor the incoming traffic from our customers and strive to ensure that traffic is controlled, in-keeping with our guidelines and not unnecessarily excessive. We would suggest a polling rate of 5 requests per second, whilst we strive towards implementing rate limiting.
Request Parameters
There are 2 optional params, that are in common with these Websocket endpoints:
“speed” - this can be “fast” or “normal”. Default is normal and only applicable for offline matches
“startPosition” : integer value, default is 0. This is how many events to skip from the beginning of the list of events. e.g. 5 would be start sending events from the 5th event received for that websocket. This is a useful feature if you want to continue without getting all the events again from the beginning when you reconnect
Full list of statistics
Team Stats
Biggest Lead
Biggest Lead Score
Current Scoring Run
Longest Scoring Run
Longest Scoring Run From Zero
Longest Scoring Run Score
Longest Scoring Run Score From Zero
Most Points in Period
Period With Most Points
Coach Ejected
Assists
Assists v Turnovers
Assists/Turnovers Ratio
Bench Points
Bench Technical Fouls
Blocks
Blocks Against
Coach Disqualifying Fouls
Coach Technical Fouls
Defensive Team Rebounds
Disqualifying Fouls
Field Goal Attempts
Field Goals Made
Field Goals %
Fouls Against
Free Throw Attempts
Free Throws Made
Free Throws %
Offensive Fouls
Offensive Rebounds
Offensive Team Rebounds
Personal Fouls
Points Off Turnovers
Second Chance Points
Steals
Team Limit Fouls
Team Rebounds
Technical Fouls
3 Pointers Attempted
3 Pointers Made
3 Pointers %
Total Points
Total Rebounds
Total Rebounds With Team Rebounds
Turnovers
2 Pointer Attempts
2 Pointers Made
2 Pointers %
Unsportsmanlike Fouls
Period Stats
Period
Assists
Assists To Turnovers
Assists to Turnovers Ratio
Bench Points
Bench Technical Fouls
Blocks
Blocks Against
Unsportsmanlike Fouls
Coach Disqualifying Fouls
Coach Technical Fouls
Defensive Rebounds
Defensive Team Rebounds
Disqualifying Fouls
Field Goal Attempts
Field Goals Made
Field Goals %
Fouls Against
Free Throw Attempts
Free Throws Made
Free Throws %
Offensive Fouls
Offensive Rebounds
Offensive Team Rebounds
Personal Fouls
Points Off Turnovers
Second Chance Points
Steals
Team Limit Fouls
Team Rebounds
Technical Fouls
3 Pointer Attempts
3 Pointers Made
3 Pointers %
Total Points
Total Rebounds
Total Rebounds With Team Rebounds
Turnovers
Two Pointer Attempts
Two Pointers Made
Two Pointers %
Unsportsmanlike Fouls
Player
Assists Ratio
Assists Ratio When On Court
Blocks Against Ratio
Blocks Against Ratio When On Court
Blocks Ratio
Blocks Ratio When On Court
Defensive Rebounds Ratio
Defensive Rebounds Ratio When On Court
Field Goals Attempts Ratio
Field Goals Attempts Ratio When On Court
Field Goals Made Ratio
Field Goals Made Ratio When On Court
Free Throw Attempts Ratio
Free Throw Attempts Ratio When On Court
Free Throws Made Ratio
Free Throws Made Ratio When On Court
Has Double Double
Has Quadruple Double
Has Triple Double
Offensive Rebounds Ratio
Offensive Rebounds Ratio When On Court
Steals Ratio
Steals Ratio When On Court
Team Assists When On Court
Team Blocks Against When On Court
Team Blocks When On Court
Team Defensive Rebounds When On Court
Team Field Goal Attempts When On Court
Team Field Goals Made When On Court
Team Free Throw Attempts When On Court
Team Free Throws Made When On Court
Team Offensive Rebounds When On Court
Team Steals When On Court
Team 3 Pointer Attempts When On Court
Team 3 Pointers Made When On Court
Team Total Points When On Court
Team Total Rebounds When On Court
Team Turnovers When On Court
Team 2 Pointer Attempts When On Court
Team 2 Pointers Made When On Court
3 Pointers Attempt Ratio
3 Pointers Attempt Ratio When On Court
3 Pointers Made Ratio
3 Pointers Made Ratio When On Court
Total Points Ratio
Total Points Ratio When On Court
Total Rebounds Ratio
Total Rebounds Ratio When On Court
Turnovers Ratio
Turnovers Ratio When On Court
2 Pointers Attempts Ratio
2 Pointers Attempts Ratio When On Court
2 Pointers Made Ratio
2 Pointers Made Ratio When On Court
Ejected
Fouled Out
Second Chance Points Ratio
Second Chance Points Ratio When On Court
Team Second Chance Points When On Court
Points Off Turnovers Ratio
Points Off Turnovers Ratio When On Court
Team Points Off Turnovers When On Court
Assists
Assists To Turnovers
Assists To Turnovers Ratio
Blocks
Blocks Against
Defensive Rebounds
Disqualifying Fouls
Field Goal Attempts
Field Goals Made
Field Goals %
Fouls Against
Free Throw Attempts
Free Throws Made
Free Throws %
Last Update Game Time
Minutes Played
Minutes Played String
Offensive Fouls
Offensive Rebounds
Personal Fouls
Player Limit Fouls
+/-
Points Off Turnovers
Second Chance Points
Steals
Technical Fouls
3 Pointer Attempts
3 Pointers Made
3 Pointers %
Total Points
Total Rebounds
Turnovers
2 Pointer Attempts
2 Pointers Made
2 Pointers %
Unsportsmanlike Fouls
Definitions
This section tags statistics to a Team, a Player or a specific period. Some stats may only be relevant for those categories.
Team
Biggest Lead
The teams biggest lead
Team
Biggest Lead Score
The score during the period of the teams biggest lead
Team
Current Scoring Run
The teams current scoring run
Team
Longest Scoring Run
The teams longest current scoring run
Team
Longest Scoring Run From Zero
The teams current scoring run from 0 points
Team
Longest Scoring Run Score
The teams longest scoring run score
Team
Longest Scoring Run Score From Zero
The teams longest scoring run score from 0 points
Team
Most Points in Period
Most points scored in a single period
Team
Period With Most Points
The period where the team accumulated the most points
Team
Coach Ejected
Coach Ejected
Team/Period/Player
Assists
The number of assist passes that lead directly to a made basket by a team or player
Team/Period/Player
Assists v Turnovers
The number of assists for a team/player and the number of turnovers they have committed
Team/Period/Player
Assists/Turnovers Ratio
The number of assists for a team or player compared to the number of turnovers they have committed
Team/Period
Bench Points
The number of points scored from players on the bench
Team/Period
Bench Technical Fouls
The number of technical fouls committed from players on the bench
Team/Period/Player
Blocks
A block occurs when an offensive player attempts a shot, and the defence player tips the ball, blocking their chance to score. This is the total number of blocks across the team or player
Team/Period/Player
Blocks Against
Number of blocks against
Team/Period
Coach Disqualifying Fouls
Number of disqualifying fouls against the coach
Team/Period
Coach Technical Fouls
Number of technical fouls against the coach
Team/Period/Player
Defensive Rebounds
Total defensive rebounds in a match (across both teams)
Team/Period
Defensive Team Rebounds
Total defensive rebounds that a team has collectively while on the court
Team/Period/Player
Disqualifying Fouls
Number of disqualifying fouls
Team/Period/Player
Field Goal Attempts
A team or players field goals attempted whilst on the court
Team/Period/Player
Field Goal Made
A team's or players field goals made whilst on the court
Team/Period/Player
Field Goals %
Field goals made / field goal attempts x 100
Team/Period/Player
Fouls Against
Number of fouls against
Team/Period/Player
Free Throw Attempts
unopposed attempt to score points from behind the free throw line
Team/Period/Player
Free Throws Made
a successful attempt at scoring points from behind the free throw line
Team/Period/Player
Free Throws %
free throws made / free throw attempts x 100
Team/Period/Player
Offensive Fouls
Number of offensive fouls committed
Team/Period/Player
Offensive Rebounds
The total number of offensive rebounds by the team or player
Team/Period
Offensive Team Rebounds
The number of offensive rebounds that a team has while on the court
Team/Period/Player
Personal Fouls
The total number of fouls committed by that team
Team/Period/Player
Points Off Turnovers
Points scored from turnovers
Team/Period/Player
Second Chance Points
Points from second chance shots
Team/Period/Player
Steals
The total number of team's steals whilst on the court
Team/Period/Player
Team Limit Fouls
The team limit fouls
Team/Period/Player
Team Rebounds
Total rebounds (offensive and defensive) that a player has while on the court
Team/Period/Player
Technical Fouls
The number of technical fouls by the team
Team/Period/Player
3 Pointers Attempted
The total number of 3 points attempted by the team
Team/Period/Player
3 Pointers Made
The total number of 3 points made by the team
Team/Period/Player
3 Pointers %
3 points made / 3 point attempts x 100
Team/Period/Player
Total Points
The total number of accumulated points
Team/Period/Player
Turnovers
A turnover occurs when the team on offence loses the ball to the defensive team
Team/Period/Player
2 Pointers Attempted
The total number of 2 points attempted by the team
Team/Period/Player
2 Pointers Made
The total number of 2 points made by the team
Team/Period/Player
2 Pointers %
2 points made / 2 point attempts x 100
Team/Period/Player
Unsportsmanlike Fouls
Total fouls which are given for unsportsmanlike behaviour
Period
Period
The period the stats relate to
Team/Period/Player
Total Rebounds
The total number of rebounds for one team
Period/Player
Total Rebounds with Team Rebounds
The total number of rebounds across the match
Player
Assists Ratio
Assist Ratio measures how often a player or team uses (uses are assists, turnovers, field goal attempts and 44 percent of free throws) are assists
Player
Assists Ratio On Court
The above but factored in when the player is on court
Player
Blocks Against Ratio
Player
Blocks Against Ratio When On Court
Player
Blocks Ratio
Player
Blocks Ratio When On Court
Player
Defensive Rebounds Ratio
Player
Defensive Rebounds Ratio When On Court
Player
Field Goals Attempts Ratio
Player
Field Goals Attempts Ratio When On Court
Player
Field Goals Made Ratio
Player
Field Goals Made Ratio When On Court
Player
Free Throw Attempts Ratio
Player
Free Throw Attempts Ratio When On Court
Player
Free Throws Made Ratio
Player
Free Throws Made Ratio When On Court
Player
Has Double Double
The number of double-doubles (double-digit number total in two of the five categories in a game) a player achieves
Player
Has Quadruple Double
The number of quadruple-doubles (double-digit number total in four of the five categories in a game) a player achieves
Player
Has Triple Double
The number of triple-doubles (double-digit number total in three of the five categories in a game) a player achieves
Player
Offensive Rebounds Ratio
Player
Offensive Rebounds Ratio When On Court
Player
Steals Ratio
Player
Steals Ratio When On Court
Player
Team Assists When On Court
The number of assists that team accumulated whilst that player was on court
Player
Team Blocks Against When On Court
The number of blocks against that team accumulated whilst that player was on court
Player
Team Blocks When On Court
The number of blocks that team accumulated whilst that player was on court
Player
Team Defensive Rebounds When On Court
The number of defensive rebounds against that team accumulated whilst that player was on court
Player
Team Field Goal Attempts When On Court
The number of field goal attempts that team accumulated whilst that player was on court
Player
Team Field Goals Made When On Court
The number of field goals made that team accumulated whilst that player was on court
Player
Team Free Throw Attempts When On Court
The number of free throw attempts that team accumulated whilst that player was on court
Player
Team Free Throws Made When On Court
The number of free throws made that team accumulated whilst that player was on court
Player
Team Offensive Rebounds When On Court
The number of offensive rebounds that team accumulated whilst that player was on court
Player
Team Steals When On Court
The number of team steals that team accumulated whilst that player was on court
Player
Team 3 Pointer Attempts When On Court
The number of 3 pointer attempts that team accumulated whilst that player was on court
Player
Team 3 Pointers Made When On Court
The number of 3 pointers made that team accumulated whilst that player was on court
Player
Team Total Points When On Court
The total number of points that team accumulated whilst that player was on court
Player
Team Total Rebounds When On Court
The total number of rebounds that team accumulated whilst that player was on court
Player
Team Turnovers When On Court
The total number of team turnovers that team accumulated whilst that player was on court
Player
Team 2 Pointer Attempts When On Court
The total number of 2 point attempts that team accumulated whilst that player was on court
Player
Team 2 Pointers Made When On Court
The total number of 2 pointers made that team accumulated whilst that player was on court
Player
3 Pointers Attempt Ratio
Player
3 Pointers Attempt Ratio When On Court
Player
3 Pointers Made Ratio
Player
3 Pointers Made Ratio When On Court
Player
Total Points Ratio
Player
Total Points Ratio When On Court
Player
Total Rebounds Ratio
Player
Total Rebounds Ratio When On Court
Player
Turnovers Ratio
Player
Turnovers Ratio When On Court
Player
2 Pointers Attempts Ratio
Player
2 Pointers Attempts Ratio When On Court
Player
2 Pointers Made Ratio
Player
2 Pointers Made Ratio When On Court
Player
Ejected
Whether the player was ejected
Player
Fouled Out
The number of fouled outs against that player
Player
Second Chance Points Ratio
Player
Second Chance Points Ratio When On Court
Player
Team Second Chance Points When On Court
Accumulated second chance points when the player is on the court
Player
Points Off Turnovers Ratio
Player
Points Off Turnovers Ratio When On Court
Player
Team Points Off Turnovers When On Court
Accumulated points from turnovers when the player is on the court
Player
Last Update Game Time
Player
Player Limit Fouls
Player
+/-
The point differential when a player or team is on the floor
Player
Minutes Played
The total number of minutes played by that play in the match e.g. 00:12:00
Player
Minutes Played String
The total number of minutes played by that play in the match e.g. 12:00
Response Model
For sample JSON files and details of each value with descriptions within the payloads, utilise the following Swagger Pages:
JSON Schema - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/basketball/getStatisticsByFixtureId
JSON Schema with value descriptions - https://app.swaggerhub.com/apis/IMG_Arena/IMGA-DDE-BASKETBALL/1.4#/Statistics
Last updated