# 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:<br>

* “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.

<table><thead><tr><th>Team/Player/Period</th><th width="217.33333333333331">Statistic Name</th><th>Description</th></tr></thead><tbody><tr><td>Team</td><td>Biggest Lead</td><td>The teams biggest lead</td></tr><tr><td>Team</td><td>Biggest Lead Score</td><td>The score during the period of the teams biggest lead</td></tr><tr><td>Team</td><td>Current Scoring Run</td><td>The teams current scoring run</td></tr><tr><td>Team</td><td>Longest Scoring Run</td><td>The teams longest current scoring run</td></tr><tr><td>Team</td><td>Longest Scoring Run From Zero</td><td>The teams current scoring run from 0 points</td></tr><tr><td>Team</td><td>Longest Scoring Run Score</td><td>The teams longest scoring run score</td></tr><tr><td>Team</td><td>Longest Scoring Run Score From Zero</td><td>The teams longest scoring run score from 0 points</td></tr><tr><td>Team</td><td>Most Points in Period</td><td>Most points scored in a single period</td></tr><tr><td>Team</td><td>Period With Most Points</td><td>The period where the team accumulated the most points</td></tr><tr><td>Team</td><td>Coach Ejected</td><td>Coach Ejected</td></tr><tr><td>Team/Period/Player</td><td>Assists</td><td>The number of assist passes that lead directly to a made basket by a team or player</td></tr><tr><td>Team/Period/Player</td><td>Assists v Turnovers</td><td>The number of assists for a team/player and the number of turnovers they have committed</td></tr><tr><td>Team/Period/Player</td><td>Assists/Turnovers Ratio</td><td>The number of assists for a team or player compared to the number of turnovers they have committed</td></tr><tr><td>Team/Period</td><td>Bench Points</td><td>The number of points scored from players on the bench</td></tr><tr><td>Team/Period</td><td>Bench Technical Fouls</td><td>The number of technical fouls committed from players on the bench</td></tr><tr><td>Team/Period/Player</td><td>Blocks</td><td>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</td></tr><tr><td>Team/Period/Player</td><td>Blocks Against</td><td>Number of blocks against</td></tr><tr><td>Team/Period</td><td>Coach Disqualifying Fouls</td><td>Number of disqualifying fouls against the coach</td></tr><tr><td>Team/Period</td><td>Coach Technical Fouls</td><td>Number of technical fouls against the coach</td></tr><tr><td>Team/Period/Player</td><td>Defensive Rebounds</td><td>Total defensive rebounds in a match (across both teams)</td></tr><tr><td>Team/Period</td><td>Defensive Team Rebounds</td><td>Total defensive rebounds that a team has collectively while on the court</td></tr><tr><td>Team/Period/Player</td><td>Disqualifying Fouls</td><td>Number of disqualifying fouls</td></tr><tr><td>Team/Period/Player</td><td>Field Goal Attempts</td><td>A team or players field goals attempted whilst on the court</td></tr><tr><td>Team/Period/Player</td><td>Field Goal Made</td><td>A team's or players field goals made whilst on the court</td></tr><tr><td>Team/Period/Player</td><td>Field Goals %</td><td>Field goals made / field goal attempts x 100</td></tr><tr><td>Team/Period/Player</td><td>Fouls Against</td><td>Number of fouls against</td></tr><tr><td>Team/Period/Player</td><td>Free Throw Attempts</td><td>unopposed attempt to score points from behind the free throw line</td></tr><tr><td>Team/Period/Player</td><td>Free Throws Made</td><td>a successful attempt at scoring points from behind the free throw line</td></tr><tr><td>Team/Period/Player</td><td>Free Throws %</td><td>free throws made / free throw attempts x 100</td></tr><tr><td>Team/Period/Player</td><td>Offensive Fouls</td><td>Number of offensive fouls committed</td></tr><tr><td>Team/Period/Player</td><td>Offensive Rebounds</td><td>The total number of offensive rebounds by the team or player</td></tr><tr><td>Team/Period</td><td>Offensive Team Rebounds</td><td>The number of offensive rebounds that a team has while on the court</td></tr><tr><td>Team/Period/Player</td><td>Personal Fouls</td><td>The total number of fouls committed by that team</td></tr><tr><td>Team/Period/Player</td><td>Points Off Turnovers</td><td>Points scored from turnovers</td></tr><tr><td>Team/Period/Player</td><td>Second Chance Points</td><td>Points from second chance shots</td></tr><tr><td>Team/Period/Player</td><td>Steals</td><td>The total number of team's steals whilst on the court</td></tr><tr><td>Team/Period/Player</td><td>Team Limit Fouls</td><td>The team limit fouls</td></tr><tr><td>Team/Period/Player</td><td>Team Rebounds</td><td>Total rebounds (offensive and defensive) that a player has while on the court</td></tr><tr><td>Team/Period/Player</td><td>Technical Fouls</td><td>The number of technical fouls by the team</td></tr><tr><td>Team/Period/Player</td><td>3 Pointers Attempted</td><td>The total number of 3 points attempted by the team</td></tr><tr><td>Team/Period/Player</td><td>3 Pointers Made</td><td>The total number of 3 points made by the team</td></tr><tr><td>Team/Period/Player</td><td>3 Pointers %</td><td>3 points made / 3 point attempts x 100</td></tr><tr><td>Team/Period/Player</td><td>Total Points</td><td>The total number of accumulated points</td></tr><tr><td>Team/Period/Player</td><td>Turnovers</td><td>A turnover occurs when the team on offence loses the ball to the defensive team</td></tr><tr><td>Team/Period/Player</td><td>2 Pointers Attempted</td><td>The total number of 2 points attempted by the team</td></tr><tr><td>Team/Period/Player</td><td>2 Pointers Made</td><td>The total number of 2 points made by the team</td></tr><tr><td>Team/Period/Player</td><td>2 Pointers %</td><td>2 points made / 2 point attempts x 100</td></tr><tr><td>Team/Period/Player</td><td>Unsportsmanlike Fouls</td><td>Total fouls which are given for unsportsmanlike behaviour</td></tr><tr><td>Period</td><td>Period</td><td>The period the stats relate to</td></tr><tr><td>Team/Period/Player</td><td>Total Rebounds</td><td>The total number of rebounds for one team</td></tr><tr><td>Period/Player</td><td>Total Rebounds with Team Rebounds</td><td>The total number of rebounds across the match</td></tr><tr><td>Player</td><td>Assists Ratio</td><td>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</td></tr><tr><td>Player</td><td>Assists Ratio On Court</td><td>The above but factored in when the player is on court</td></tr><tr><td>Player</td><td>Blocks Against Ratio</td><td></td></tr><tr><td>Player</td><td>Blocks Against Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Blocks Ratio</td><td></td></tr><tr><td>Player</td><td>Blocks Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Defensive Rebounds Ratio</td><td></td></tr><tr><td>Player</td><td>Defensive Rebounds Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Field Goals Attempts Ratio</td><td></td></tr><tr><td>Player</td><td>Field Goals Attempts Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Field Goals Made Ratio</td><td></td></tr><tr><td>Player</td><td>Field Goals Made Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Free Throw Attempts Ratio</td><td></td></tr><tr><td>Player</td><td>Free Throw Attempts Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Free Throws Made Ratio</td><td></td></tr><tr><td>Player</td><td>Free Throws Made Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Has Double Double</td><td>The number of double-doubles (double-digit number total in two of the five categories in a game) a player achieves</td></tr><tr><td>Player</td><td>Has Quadruple Double</td><td>The number of quadruple-doubles (double-digit number total in four of the five categories in a game) a player achieves</td></tr><tr><td>Player</td><td>Has Triple Double</td><td>The number of triple-doubles (double-digit number total in three of the five categories in a game) a player achieves</td></tr><tr><td>Player</td><td>Offensive Rebounds Ratio</td><td></td></tr><tr><td>Player</td><td>Offensive Rebounds Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Steals Ratio</td><td></td></tr><tr><td>Player</td><td>Steals Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Team Assists When On Court</td><td>The number of assists that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Blocks Against When On Court</td><td>The number of blocks against that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Blocks When On Court</td><td>The number of blocks that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Defensive Rebounds When On Court</td><td>The number of defensive rebounds against that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Field Goal Attempts When On Court</td><td>The number of field goal attempts that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Field Goals Made When On Court</td><td>The number of field goals made that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Free Throw Attempts When On Court</td><td>The number of free throw attempts that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Free Throws Made When On Court</td><td>The number of free throws made that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Offensive Rebounds When On Court</td><td>The number of offensive rebounds that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Steals When On Court</td><td>The number of team steals that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team 3 Pointer Attempts When On Court</td><td>The number of 3 pointer attempts that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team 3 Pointers Made When On Court</td><td>The number of 3 pointers made that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Total Points When On Court</td><td>The total number of points that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Total Rebounds When On Court</td><td>The total number of rebounds that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team Turnovers When On Court</td><td>The total number of team turnovers that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team 2 Pointer Attempts When On Court</td><td>The total number of 2 point attempts that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>Team 2 Pointers Made When On Court</td><td>The total number of 2 pointers made that team accumulated whilst that player was on court</td></tr><tr><td>Player</td><td>3 Pointers Attempt Ratio</td><td></td></tr><tr><td>Player</td><td>3 Pointers Attempt Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>3 Pointers Made Ratio</td><td></td></tr><tr><td>Player</td><td>3 Pointers Made Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Total Points Ratio</td><td></td></tr><tr><td>Player</td><td>Total Points Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Total Rebounds Ratio</td><td></td></tr><tr><td>Player</td><td>Total Rebounds Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Turnovers Ratio</td><td></td></tr><tr><td>Player</td><td>Turnovers Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>2 Pointers Attempts Ratio</td><td></td></tr><tr><td>Player</td><td>2 Pointers Attempts Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>2 Pointers Made Ratio</td><td></td></tr><tr><td>Player</td><td>2 Pointers Made Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Ejected</td><td>Whether the player was ejected</td></tr><tr><td>Player</td><td>Fouled Out</td><td>The number of fouled outs against that player</td></tr><tr><td>Player</td><td>Second Chance Points Ratio</td><td></td></tr><tr><td>Player</td><td>Second Chance Points Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Team Second Chance Points When On Court</td><td>Accumulated second chance points when the player is on the court</td></tr><tr><td>Player</td><td>Points Off Turnovers Ratio</td><td></td></tr><tr><td>Player</td><td>Points Off Turnovers Ratio When On Court</td><td></td></tr><tr><td>Player</td><td>Team Points Off Turnovers When On Court</td><td>Accumulated points from turnovers when the player is on the court</td></tr><tr><td>Player</td><td>Last Update Game Time</td><td></td></tr><tr><td>Player</td><td>Player Limit Fouls</td><td></td></tr><tr><td>Player</td><td>+/-</td><td>The point differential when a player or team is on the floor</td></tr><tr><td>Player</td><td>Minutes Played</td><td>The total number of minutes played by that play in the match e.g. 00:12:00</td></tr><tr><td>Player</td><td>Minutes Played String</td><td>The total number of minutes played by that play in the match e.g. 12:00</td></tr></tbody></table>

## 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>