Basketball

Sport specific information for basketball

Match statuses in basketball

ID	Match status	Description	Additional information
0	NOT_STARTED	Not started yet	-
1	FIRST_PERIOD	1st halftime	This match status is only sent for NCAA men matches.
13	FIRST_QUARTER	1st quarter	-
301	FIRST_PAUSE	1st pause	-
14	SECOND_QUARTER	2nd quarter	-
302	SECOND_PAUSE	2nd pause	-
31	HALFTIME	Halftime break	This match status is only sent for NCAA men matches.
2	SECOND_PERIOD	2nd halftime	This match status is only sent for NCAA men matches.
15	THIRD_QUARTER	3rd quarter	-
303	THIRD_PAUSE	3rd pause	-
16	FORTH_QUARTER	4th quarter	-
100	ENDED	The match has ended	-
32	AWAITING_OT	Waiting for overtime to start	This match status is only sent if the corresponding XML configuration is enabled.
40	OVERTIME	Overtime (in case match goes to extra time)	-
110	AFTER_OT	Match finished after overtime	This match status is only sent if the corresponding XML configuration is enabled.
61	DELAYED	The match start is delayed	-
80	INTERRUPTED	The match has been interrupted	-
90	ABANDONED	The match has been abandoned	This match status is only sent if the corresponding XML configuration is enabled.

Events in Basketball

Blue text = NBA & WNBA unique data points if covered by device ID 5 (External Feed) in deeper coverage (dc = 1). This is based on official NBA NGSS data feeds.

ID	Event	Description	Coverage	Special XML Attributes	Player1	Player2
60	Substitution	Used when a substitution of players occurs	iScout (DC), XSA (DC), External Feed (DC)	Happenedat: UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact.	Id of player going out	Id of player going in
110	Possession	Indicates which team is currently in possession of the ball.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
129	Foul	Used when a foul is committed. Entries are assigned to teams.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Possible values: -1 = Unknown 1 = Other Personal Foul 2 = Shooting Foul 3 = Offensive Foul 4 = Technical Foul 5 = Flagrant Foul Foultypedescriptor: Description of the foul. Possible values: 1 = charge 2 = off the ball 3 = take 4 = double 5 = shooting 6 = clear path 7 = loose ball 8 = blocking 9 = player control 10 = shooting block 11 = elbow 12 = punching 13 = flagrant type 1 14 = flagrant type 2 15 = away from play 16 = inbound 17 = non-unsportsmanlike 18 = rim hanging 19 = delay 20 = taunting 21 = indirect 22 = excess timeout 23 = too many players 24 = defensive 3 second 25 = flopping 26 = bench Foultypequalifier: Additional classification of the foul type. One event can have more than one foultypequalifier. Possible values: 1 = 1 free throw 2 = 2 free throw 3 = 3 free throw 4 = in penalty 5 = team Posx: Approximated horizontal foul location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical foul location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Id of fouling player. Only if present.	Id of fouled player. Only if present.
1010	Betstart	Betstart indicates that betting markets can be activated. Betstart is not only a pre match event but is also used during the match.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1011	Betstop	Betstop indicates that all betting markets are closed due to strong possibility of a goal, penalty, red card, or there is any unclear situation on the field. Betstop is also used whenever there is the need to establish direct communication between the scout and the match Supervisor, or in case of call disconnection.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1013	Match status	Sent when the status of the match changes.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: See above table for match statuses available for Basketball.	-	-
1015	Free comment	Free text message. Free comment is used for any kind of additional information during the match. For example: "players on court" and "players are warming up".	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1024	Match about to start	Match is about to start	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1033	Won jump ball team	Information about which team won the jump ball. Jump ball is used to begin play and sometimes to resume play.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Tippedto: Id of player who got the ball. Only if present.	ID of player who won the jump ball. Only if present.	ID of player who lost the jump ball. Only if present.
1034	Rebound	Rebound awarded to a player who retrieves the ball after a missed field goal or free throw.	iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Rebound type. Possible values: 0 = Defensive 1 = Offensive -1 = Unknown Posx: Approximated horizontal rebound location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical rebound location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	ID of rebounding player. Only if present.	-
1035	Timeout	A team calls a timeout. Entries can be assigned to teams, but neutral timeouts are possible too.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1036	Time start stop	Match clock is stopped or started.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Possible values: 1 = Time started 0 = Time stopped	-	-
1037	Score change	Used when a team scores points. Entries are assigned to teams.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Possible values: 1 = Free throw (1 point) 2 = 2-pointer 3 = 3-pointer 4 = 4-pointer Extrainfobasketball: Score type. Enabled by LD XML config ID 28. Possible values: -1 = Unknown 1 = Invalid (only used in cases where free throw is made, but some kind of violation occurs like player steps over the line or similar) 2 = Fast break (provided via scoretypequalifier instead) 3 = Dunk 4 = Layup 5 = Putback (provided via secondscoretype instead) 6 = Tip-in (provided via secondscoretype instead) 7 = Alley-Oop (provided via secondscoretype instead) 8 = Jump Shot 9 = Hook Secondscoretype: Additional score type. Enabled by LD XML config ID 46. Possible values: -1 = Unknown 1 = Invalid (provided via extrainfobasketball) 2 = Fast break (provided via scoretypequalifier) 3 = Dunk (provided via extrainfobasketball) 4 = Layup (provided via extrainfobasketball) 5 = Putback 6 = Tip-in 7 = Alley-Oop 10 = Bank 11 = Cutting (including cutting finger roll) 12 = Driving (including driving bank, driving finger roll, driving floating, driving floating bank & driving reverse) 13 = Fadeaway (including fadeaway bank) 14 = Finger roll 15 = Floating 16 = Pullup (including pullup bank) 17 = Reverse 18 = Running (including running alley oop, running finger roll, running pullup & running reverse, 19 = Step back (including step back bank) 20 = Turnaround (including turnaround bank, turnaround fadeaway & turnaround fadeaway bank) Scoretypequalifier: Additional score type qualifier. One event can have more than one scoretypequalifier. Enabled by LD XML config ID 46. Possible values: 1 = 2nd chance 2 = Fast break 3 = From turnover 4 = Defensive goal tending 5 = Points in the paint Happenedat: UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact. Posx: Approximated horizontal shot location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical shot location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Id of scoring player. Only if present.	Id of assisting player. Only if present.
1038	Score miss	Used when a point attempt missed.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Possible values: 1 = Free throw (1 point) 2 = 2-pointer 3 = 3-pointer 4 = 4-pointer Extrainfobasketball: Score type. Enabled by LD XML config ID 28. Possible values: -1 = Unknown 1 = Invalid (only used for free throws. I.e. if player misses but defender steps into the lane too early so the shooter gets a new try) 3 = Dunk 4 = Layup 8 = Jump Shot 9 = Hook Secondscoretype: Additional score type. Enabled by LD XML config ID 46. Possible values: -1 = Unknown 5 = Putback 6 = Tip-in 7 = Alley-Oop 10 = Bank 11 = Cutting (including cutting finger roll) 12 = Driving (including driving bank, driving finger roll, driving floating, driving floating bank & driving reverse) 13 = Fadeaway (including fadeaway bank) 14 = Finger roll 15 = Floating 16 = Pullup (including pullup bank) 17 = Reverse 18 = Running (including running alley oop, running finger roll, running pullup & running reverse, 19 = Step back (including step back bank) 20 = Turnaround (including turnaround bank, turnaround fadeaway & turnaround fadeaway bank) Scoretypequalifier: Additional score type qualifier. One event can have more than one scoretypequalifier. Enabled by LD XML config ID 46. Possible values: 1 = 2nd chance 2 = Fast break 3 = From turnover 4 = Defensive goal tending 5 = Points in the paint Posx: Approximated horizontal shot location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical shot location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Id of shooting player. Only if present.	-
1039	Manual time adjustment	Manual adjustment of time.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Number of seconds adjusted. Either a positive or a negative integer.	-	-
1044	Delete event alert	Manual removal of an event.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Id of event that was deleted.	-	-
1047	Timeout over	Used when timeout is over.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1056	Number free throws	Free throws awarded to a player.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Number of free throws. (1 - 4) Extrainfobasketball: Possible values: 1 = If it is a 1+1 free throw. (NCAA only)	ID of player who is likely to throw the free throw(s)	-
1062	Ball position	Position of the ball on the court in x/y coordinates.	iScout (BC+DC), XSA (DC)	-	-	-
1102	Coverage status	Scout match coverage status. Coverage abandoned status means that coverage is stopped after it had already been started. Match will not be covered status means that match was supposed to be covered but coverage has been cancelled before.	Hardphone (BC), iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Possible values: 0 = Covered 1 = Coverage abandoned 2 = Match will not be covered	-	-
1437	TV timeout start	Start of a break in the game to allow television advertisements to be show. Can be attributed to home team, away team or no team ("official's timeout"), but side attribute is always set to "none".	iScout (BC+DC), XSA (DC)	-	-	-
1438	TV timeout over	End of a break in the game to allow television advertisements to be show. Can be attributed to home team, away team or no team ("official's timeout"), but side attribute is always set to "none".	iScout (BC+DC), XSA (DC)	-	-
1458	Video review	Used when a video review of a referee call occurs	iScout (BC+DC), XSA (DC), External Feed (DC)	-	-	-
1459	Video review over	Used when a video review of a referee call is over	iScout (BC+DC), XSA (DC), External Feed (DC)	Extrainfo: Possible values: 0 = call stands 1 = call overturned	-	-
1550	Score adjustment	Manual period score adjustment in RTS	External Feed (BC)	Extrainfo: Number of period being adjusted Extrainfobasketball: Updated period score (the one that was adjusted) and full score. Possible Values: <home_period_score>:<away_period_score> <home_full_score>:<away_full_score>	-	-
1603	Basketball play start	Indication that a free throw will be thrown shortly (player on the free throw line)	XSA (DC)	-	-	-
1604	Basketball play over	Indication that the free throw sequence is over	XSA (DC)	-	-	-
1605	Basketball play cancelled	If scout enters a "play start" by mistake, he/she can cancel it with "play cancelled"	XSA (DC)	-	-	-
1714	Player match stats	Accumulated Player match statistics sent in real-time based on NBA NGSS data. It includes a total count and one count for each quarter or overtime. Event will not be available in case of failover.	External Feed (DC)	Statistics format: Total stats will always be present. Accumulated period stats will only be present for the affected period stats. homeplayerstatstotal=PLAYERSTATS|PLAYERSTATS|... awayplayerstatstotal=PLAYERSTATS|PLAYERSTATS|... homeplayerstatsp1=PLAYERSTATS|PLAYERSTATS|... awayplayerstatsp1=PLAYERSTATS|PLAYERSTATS|... homeplayerstatsp2=PLAYERSTATS|PLAYERSTATS|... awayplayerstatsp2=PLAYERSTATS|PLAYERSTATS|... homeplayerstatsp3=PLAYERSTATS|PLAYERSTATS|... awayplayerstatsp3=PLAYERSTATS|PLAYERSTATS|... homeplayerstatsp4=PLAYERSTATS|PLAYERSTATS|... awayplayerstatsp4=PLAYERSTATS|PLAYERSTATS|... homeplayerstatsot=PLAYERSTATS|PLAYERSTATS|... awayplayerstatsot=PLAYERSTATS|PLAYERSTATS|... PLAYERSTATS -> PID=NNNNNN;...(attributes below) PID -> playerId (int) is a basic value (present on all attributes) 2PM → Two Pointer Made: Numeric value. 2PA → Two Pointer Attempted: Numeric value. 2PP → Two Pointer Percentage: decimal values from 0.0 to 100.0 3PM → Three Pointer Made: Numeric value. 3PA → Three Pointer Attempted: Numeric value. 3PP → Three Pointer Percentage: decimal values from 0.0 to 100.0 FTM → Free Throw Made: Numeric value. FTA → Free Throw Attempted: Numeric value. FTP → Free Throw Percentage: decimal values from 0.0 to 100.0 OREB → Offensive Rebounds: Numeric value. DREB → Defensive Rebounds: Numeric value. REB → Rebounds: Numeric value. AST → Assists: Numeric value. STL → Steals: Numeric value. BLK → Blocks: Numeric value. TO → Turnovers: Numeric value. PF → Personal Fouls: Numeric value. PTS → Points: Numeric value.	-	-
1732	Player disqualified	Player is disqualified and must leave the court. Also called "ejection".	iScout (DC), XSA (DC), External Feed (DC)	Extrainfo: Disqualification reason. Possible values: 1 = technical 2 = second technical 3 = second flagrant type 1 4 = flagrant type 2 5 = other Happenedat: UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact.	Id of disqualified player. Only if present.	-
1733	Steal basketball	A steal occurs when a defensive player legally causes a turnover	XSA (DC), External Feed (DC)	Posx: Approximated horizontal location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Id of player who stole the ball. Only if present.	Id of player who lost the ball. Only if present.
1734	Turnover basketball	Turnover occurs when a team loses possession of the ball to the opposing team before a player takes a shot at his team's basket	XSA (DC), External Feed (DC)	Extrainfo: Turnover type. Possible values: -1 = unknown 1 = travelling 2 = bad pass 3 = lost ball 4 = double dribble 5 = out of bounds 6 = palming 7 = shot clock violation 8 = back court violation 9 = three second violation 10 = five seconds violation 11 = eight seconds violation 12 = offensive foul 13 = too many players 14 = excess timeout 15 = basket from below 16 = swingingel bows 17 = punched ball 18 = opposite basket 19 = jump ball violation 20 = lane violation 21 = inbound 22 = discontinue dribble 23 = offensive goaltending 24 = 5 sec in bound violation 25 = offensive kicked ball 26 = illegal assist 27 = illegal out of bounds screen 28 = 5 second back to the basket 29 = 10 second free throw shooter Posx: Approximated horizontal location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Id of player who turned over the ball	-
1735	Block basketball	A block or occurs when a defensive player legally deflects a field goal attempt from an offensive player	XSA (DC), External Feed (DC)	Posx: Approximated horizontal location on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline. Only if present. Posy: Approximated vertical location on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Id of blocking player. Only if present.	Id of blocked player. Only if present.
1742	Score event correction	Used to convert two-pointers into three-pointers and vice versa	XSA (DC), External Feed (DC)	Extrainfo: Id of corrected score change event	-	-
1743	Team match stats	Accumulated Team match statistics sent in real-time based on NBA NGSS data. It includes a total count and one count for each quarter or overtime. Event will not be available in case of failover.	External Feed (DC)	Statistics format: Total stats will always be present. Accumulated period stats will only be present for the affected period stats. hometeamstatstotal=TEAMSTATS awayteamstatstotal=TEAMSTATS hometeamstatsp1=TEAMSTATS awayteamstatsp1=TEAMSTATS hometeamstatsp2=TEAMSTATS awayteamstatsp2=TEAMSTATS hometeamstatsp3=TEAMSTATS awayteamstatsp3=TEAMSTATS hometeamstatsp4=TEAMSTATS awayteamstatsp4=TEAMSTATS hometeamstatsot=TEAMSTATS awayteamstatsot=TEAMSTATS TEAMSTATS -> 2PM=NNNNNN;...(attributes below) 2PM → Two Pointer Made: Numeric value. 2PA → Two Pointer Attempted: Numeric value. 2PP → Two Pointer Percentage: decimal values from 0.0 to 100.0 3PM → Three Pointer Made: Numeric value. 3PA → Three Pointer Attempted: Numeric value. 3PP → Three Pointer Percentage: decimal values from 0.0 to 100.0 FTM → Free Throw Made: Numeric value. FTA → Free Throw Attempted: Numeric value. FTP → Free Throw Percentage: decimal values from 0.0 to 100.0 OREB → Offensive Rebounds: Numeric value. DREB → Defensive Rebounds: Numeric value. REB → Rebounds Total = Rebounds offensive + Rebounds defensive + Team Rebounds (i.e. ball out of bounce after missed shot): Numeric value. AST → Assists: Numeric value. STL → Steals: Numeric value. BLK → Blocks: Numeric value. TO → Turnovers: Numeric value. TF → Team Fouls: Numeric value. FTG → Fouls To Give: Numeric value. PTS → Points: Numeric value.	-	-
2233	Players time on court	Time spent on court by each player based on NBA NGSS data. Event will be updated every 8-10 seconds. Event will not be available in case of failover.	External Feed (DC)	Hometimeoncourt: Time on court spent by home team players. Format: "PID=ss;PID=ss;PID=ss" - List of key=value pairs separated by semicolon (";"), where key is player ID and value is time spent on court in seconds Awaytimeoncourt: Time on court spent by away team players Format: "PID=ss;PID=ss;PID=ss" - List of key=value pairs separated by semicolon (";"), where key is player ID and value is time spent on court in seconds	-	-
2237	Players on court	Sent at the beginning of every period and updated whenever a player leaves or enters the court.	External Feed (DC)	homeplayers: List of home player IDs which are currently on court. Format: "PID;PID;PID" (list of players ids split by semicolon) awayplayers: List of away player IDs which are currently on court. Format: "PID;PID;PID" (list of players ids split by semicolon) Happenedat: UNIX timestamp indicating when the event actually happened. Available only if the event had to be added after the fact.	-	-
2332	Elam Ending	Indicates an Elam Ending start in TBT. Elam Ending: At the first stoppage at or under 4:00 of the 4th quarter, the game clock stops and timed play ends. At this juncture, a target score is set, equal to the leading team's score plus eight (8). After returning from the media timeout, play will resume without a game clock but with the shot clock, until one team matches or exceeds the target score. During the untimed portion (the Elam Ending), any foul on the floor (i.e., any non-offensive, non-shooting foul) while in the bonus shall result in one free throw and the fouled team’s continued possession of the ball. Example: Team A leads Team B 70-63 at the first stoppage under 4:00. The game clock is turned off while the shot clock remains on. The target score is set to 78. The first team that reaches 78 wins the game.	iScout (BC+DC), XSA (DC)	Extrainfo: Integer containing the Target Score.	-	-
2396	Possible free throws awarded	Occurs during Bonus time at the exact moment there is a foul resulting in possible free throws for one of the teams.	External Feed (DC)	Extrainfo: Number of free throws. (1 - 4)	ID of player who is likely to throw the free throw(s)
2397	Free throws not confirmed	Used when possible free throws are not confirmed.	External Feed (DC)

Sport specific XML elements and attributes

This section explains what elements / attributes one can expect for Basketball matches in addition to the standard elements and attributes, and what the meaning of those elements and attributes is.

Attributes in <match>-element

XML example

<match t1namenatural="Charlotte Hornets" t2namenatural="Toronto Raptors" t2name="TORONTO RAPTORS" t2id="19389" t1name="CHARLOTTE HORNETS" t1id="236032" t1abbr="CHA" t2abbr="TOR" start="1607990400000" matchid="24699292" feedtype="full" extrainfo="7" distance="946" betstatus="BETSTOP" connectionstatus="0" dc="1" device="3" coveredfrom="venue" timerunning="0" wonjumpball="away" st1id="3430" st2id="3433" matchtime="48:00" sportid="2" stime="1608117496346"> 
...
</match>

XML elements and attributes definition

Element	Attributes	Description	Possible values
Match	extrainfo	Integer specifying special information for the match.	Integer. Possible values: 0 = Default (4x10 minutes) 7 = 4 x 12 minutes 17 = 2 x 20 minutes 60 = 2 x 10 minutes 64 = 4 x 6 minutes 68 = 4 x 5 minutes 70 = 4 x 4 minutes 81 = 4 x 9 minutes & Elam Ending (event ID 2332) 82 = 4 x 12 minutes, 4-pointer possible
	wonjumpball	Which team won the jump ball.	String. "home" "away".
	timerunning	Whether the time is running.	Integer. 1 = Time is running 0 = Time is not running

Elements in <match> element

XML example

<match t1namenatural="Charlotte Hornets" t2namenatural="Toronto Raptors" t2name="TORONTO RAPTORS" t2id="19389" t1name="CHARLOTTE HORNETS" t1id="236032" t1abbr="CHA" t2abbr="TOR" start="1607990400000" matchid="24699292" feedtype="full" extrainfo="7" distance="946" betstatus="BETSTOP" connectionstatus="0" dc="1" device="3" coveredfrom="venue" timerunning="0" wonjumpball="away" st1id="3430" st2id="3433" matchtime="48:00" sportid="2" stime="1608117496346">
<status start="1607999474587" name="ENDED" id="100"/>
<score type="current" t2="112" t1="109"/>
<score type="period4" t2="27" t1="22"/>
<score type="period1" t2="22" t1="30"/>
<score type="period2" t2="35" t1="30"/>
<score type="period3" t2="28" t1="27"/>
<events> 
...
</events>
<tournament name="NBA Preseason" id="9154"/>
<category name="USA" id="15"/>
<sport name="Basketball" id="2"/>
<jerseys>
<jersey side="1" jersey_type="0" base="FFFFFF" outline="00CACA" number="800080"/>
<jersey side="2" jersey_type="1" base="CC0000" outline="000000" number="FFFFFF"/>
</jerseys>
</match> 

XML elements and attributes definition

Element	Attributes	Description	Possible values
score		Multiple occurrences possible, each occurrence describes the amount of points for the specified period in the match. This element always gets included in full feed, and in the delta feed for the following events: Basketball score change (1037), and Score event correction (1742)
	t1	Amount of points home team	Integer
	t2	Amount of points away team	Integer
	type	For what period in the match the points were scored.	String. Possible values: current period1 period2 period3 period4
possession		This element always gets included in full feed (DC matches only), and in the delta feed (DC matches only) for the following events: Possession (110)
	t1	Possession percentage home team	Integer
	t2	Possession percentage away team	Integer
	type	Team currently in possession	String. Possible values: "home" "away"

Attributes in <event> element

XML example

<!-- Example 1 -->
<match matchid="24699292" feedtype="delta" betstatus="STARTED" connectionstatus="1" timerunning="1" wonjumpball="away">
<possession team="home"/>
<events>
<event type="1038" stime="1607991048876" side="away" mtime="00:30" info="3 points missed [T2]" id="2565321759" uuid="662eccb5-4898-4b93-b59e-0e9bafbf511d" extrainfo="3" posx="34" posy="71" matchscore="0:0" remainingtimeperiod="11:30" periodnumber="1" matchstatus="FIRST_QUARTER"/> 
</events>
</match>

<match matchid="24699292" feedtype="delta" betstatus="STARTED" connectionstatus="1" timerunning="1" wonjumpball="away">
<possession team="home"/>
<events>
<event type="1742" stime="1607999468638" side="home" mtime="48:00" info="Points scored corrected from 3 to 2 [T1]" id="2565400617" uuid="738521f5-d69d-49fc-abaf-1f3aa7e59c95" extrainfo="2565400553" matchscore="109:112" remainingtimeperiod="00:00" periodnumber="4" correctedfrom="3" correctedto="2" matchstatus="FOURTH_QUARTER"/> 
</events>
</match>

XML attributes definition

Element	Attributes	Description	Possible values
event	extrainfo	Attribute containing additional information about the event.	Long
	posx	Horizontal position on court, posx being a number from 0 to 100. The reference point 0 is at home teams baseline.	Number
	posy	Vertical position on court, posy being a number from 0 to 100. The reference point 0 is on top of court when home teams baseline is on the left hand side.	Number
	player1	Sportradar player id for player 1 connected to this event.
	player2	Sportradar player id for player 2 connected to this event.
	matchscore	Score for current match.	String. Format: "[home]:[away]" Example: "1:0"
	remainingtimeperiod	Remaining time of the period.	String. Format: "MM:SS"
	periodnumber	Number of current period in match.	Integer
	extrainfobasketball	Attribute containing additional information about the event.	String
	correctedfrom	previous points value of the corrected score change event (event ID 1742)	Integer
	correctedto	new points value of the corrected score change event (event ID 1742)	Integer

XML configurations for Basketball

This section explains what XML configurations one can expect for this sport in addition to the standard XML configurations, and what the meaning of these configurations is.

(ID: 10) Basketball OT matchstatuses

Enabling this setting will add the following possible match statuses for basketball matches:

• AWAITING_OT

• AFTER_OT

(ID: 28) Include extrainfobasketball attribute

Enabling this setting will add an additional attribute extrainfobasketball to the <event> element. The value of this attribute is explained in the event list.

XML example

<event type="1550" extrainfo ="2" extrainfobasketball="5:6,23:15" id="422510698" info="Score adjusted for 2nd Period. New matchscore: 23:15"
matchscore="23:15" mtime="14:09" periodnumber="2" remainingtimeperiod="05:51" side="none" stime="1435190811853"/>
<!-- Remaining message truncated -->
</match>

(ID: 32) Include Periodx score type

Enabling this setting will add an attribute type in the <score> element, the attribute type can have one of the following values in addition to the regular values for Basketball matches:

• period1

• period2

• period3

• period4

XML example

<match matchid="7440630" ... >
<score t1="14" t2="20"type="period1"/>
<!−−Remaining message truncated−−>
</match>

(ID: 36) Include Lineups

Enabling this settings will allow the lineups event to be sent. Lineups are sent when subscribing to a match or when the lineup change.

XML example

<lineups matchid="6856980">
<player id="215634" name="Clark, Ian" shirtnumber="5" substitute="0" team="1"/>
<player id="801224" name="Ingles, Joe" shirtnumber="7" substitute="0" team="1"/>
<!−−Remaining message truncated−−>
</lineups>

(ID: 37) Include Basketball v2 upgrades

Enabling this setting will add the event 1742 (Score event correction): correctedfrom and correctedto as additional attributes to the <event> element. Those attributes contain respectively the old value of the score event, and the new updated value.

XML example

<event correctedfrom ="3" correctedto ="2"  extrainfo ="435180082" id="435180084" info="Points scored corrected from 3 to 2 [T1]" matchscore="5:7" mtime="10:00" periodnumber="1" remainingtimeperiod="00:00" side="home" stime="1438860996364" type="1742"/>

(ID: 46) Include Attribute secondscoretype

Enabling this setting will add the attributes secondscoretype and scoretypequalifier to event ID 1037 (score change) and event ID 1038 (score miss) to the <event> element. These attributes give more detailed information about the score change event.

XML example

<event type="1037" stime="1654909677800" side="home" mtime="00:10" info="2 points (layup,driving) [T1] -M.Smart" id="2170664751" uuid="92664b0f-959a-44f1-8ef0-903ff3f69461" extrainfo="2" posx="88" posy="46" player1="607636" player2="1141196" matchscore="2:0" remainingtimeperiod="11:50" periodnumber="1" extrainfobasketball="4" secondscoretype="12" scoretypequalifier="5" matchstatus="FIRST_QUARTER"/> 

(ID: 75) Include Ball spotting

Enabling this setting will enable the ball position event (1062).

(ID: 156) Include time on court in Basketball

Enabling this setting will add the event 2233 (Players Time on Court) to the Live Data XML Feed for matches covered with NBA NGSS data.

XML example

<match matchid="10115268" ... >
...  
<event type="2233" stime="1642731245775" side="none" mtime="32:59" id="2165963005" uuid="aea91253-3928-4b1c-a691-b511506875ea" matchscore="55:79" remainingtimeperiod="03:01" periodnumber="3" matchstatus="THIRD_QUARTER" hometimeoncourt="1491414=482;1315510=303;1770168=1572;607850=1270;608108=1662;608288=1508;1491436=515;608034=708;1478984=1257;607750=547" awaytimeoncourt="1296160=1572;1497683=1271;1770174=654;1307780=657;607970=1401;1497693=303;608210=303;996321=1418;1142606=1552;1304668=694"/>
 </events>
</match>

(ID: 157) Include player match statistics Basketball

Enabling this setting will add the event 1714 (Player match stats) to the Live Data XML Feed for matches covered with NBA NGSS data.

XML example

<event type="1714" stime="1643716141987" side="none" mtime="19:57" info="Player Statistics Update" id="2166185793" uuid="79302c09-7d52-44d6-98fa-5bce1eda6060" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" homeplayerstatstotal="PID=607440;2PM=2;2PA=3;2PP=66.7;3PM=1;3PA=3;3PP=33.3;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=0;REB=0;AST=3;STL=0;BLK=1;TO=1;PF=0;PTS=7" homeplayerstatsp1="PID=607440;2PM=2;2PA=3;2PP=66.7;3PM=1;3PA=3;3PP=33.3;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=0;REB=0;AST=3;STL=0;BLK=1;TO=1;PF=0;PTS=7"/>

<event type="1714" stime="1643716146968" side="none" mtime="19:57" info="Player Statistics Update" id="2166185812" uuid="1788442c-d886-4864-aaf6-239030ff5bb8" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" awayplayerstatstotal="PID=1491410;2PM=0;2PA=1;2PP=0.0;3PM=0;3PA=0;3PP=0.0;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=1;REB=1;AST=0;STL=0;BLK=0;TO=0;PF=0;PTS=0" awayplayerstatsp1="PID=1491410;2PM=0;2PA=1;2PP=0.0;3PM=0;3PA=0;3PP=0.0;FTM=0;FTA=0;FTP=0.0;OREB=0;DREB=1;REB=1;AST=0;STL=0;BLK=0;TO=0;PF=0;PTS=0"/>

(ID: 158) Include team match statistics Basketball

Enabling this setting will add the event 1743 (Team match stats) to the Live Data XML Feed for matches covered with NBA NGSS data.

XML example

<event type="1743" stime="1643716138966" side="none" mtime="19:57" info="Team Statistics Update" id="2166185790" uuid="7be328cc-f195-4943-955a-83f6cbd89996" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" hometeamstatstotal="2PM=5;2PA=8;2PP=62.5;3PM=3;3PA=7;3PP=42.9;FTM=4;FTA=4;FTP=100.0;OREB=1;DREB=5;REB=7;AST=5;STL=2;BLK=3;TO=3;TF=2;FTG=2;PTS=23" hometeamstatsp1="2PM=5;2PA=8;2PP=62.5;3PM=3;3PA=7;3PP=42.9;FTM=4;FTA=4;FTP=100.0;OREB=1;DREB=5;REB=7;AST=5;STL=2;BLK=3;TO=3;TF=2;PTS=23"/>


<event type="1743" stime="1643716146968" side="none" mtime="19:57" info="Team Statistics Update" id="2166185813" uuid="790a943e-1fb1-4d12-9ae8-18393313c1a5" matchscore="38:38" remainingtimeperiod="04:03" periodnumber="2" matchstatus="SECOND_QUARTER" awayteamstatstotal="2PM=5;2PA=11;2PP=45.5;3PM=1;3PA=3;3PP=33.3;FTM=2;FTA=2;FTP=100.0;OREB=1;DREB=6;REB=8;AST=2;STL=2;BLK=0;TO=6;TF=2;FTG=2;PTS=15" awayteamstatsp1="2PM=5;2PA=11;2PP=45.5;3PM=1;3PA=3;3PP=33.3;FTM=2;FTA=2;FTP=100.0;OREB=1;DREB=6;REB=8;AST=2;STL=2;BLK=0;TO=6;TF=2;PTS=15"/>

(ID: 162) Include player positions in lineups Basketball

Enabling this setting will add player positions to the Live Data XML Feed lineups for Basketball matches if available

Attribute	Description	Possible values
position	Where the player is typically playing in the field based on the season.	G = Guard F = Forward C = Center G-F = Guard-Forward F-G = Forward-Guard F-C = Forward-Center C-F = Center-Forward

XML example

<lineups matchid="6856980">
<player id="215634" name="Clean, Ian" shirtnumber="5" substitute="0" position="G" team="1"/>
<player id="801224" name="Inges, Joe" shirtnumber="7" substitute="0" position="C-F" team="1"/>
<!−−Remaining message truncated−−>
</lineups>

(ID: 163) Include players on court Basketball

Enabling this setting will add players on court event 2237 to the Live Data XML Feed for Basketball matches if available

XML example

<event type="2237" stime="1657877049267" side="home" mtime="00:00" info="Players on court - J.Tatum, A.Horford, R.Williams, J.Brown, M.Smart" id="2170664577" uuid="bd97f3c2-3769-4051-a6b1-150328ea74d1" matchscore="0:0" remainingtimeperiod="12:00" periodnumber="1" matchstatus="NOT_STARTED" homeplayers="1141196;607754;1433761;996297;607636"/> 

(ID: 209 ) Include Substitution In/Out events in the feed

Enabling this config will display events 2393 and 2394 - Substitution In and Substitution Out

(ID: 213) Include specific contracts for basketball lineup players in the feed

Enabling this config will show specific contracts for players in the lineups (2-way contract an 10-day contract)

XML example

<lineups matchid="124210546">
<player id="607922" name="Bogdanovic, Bogdan" shirtnumber="13" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="608170" name="Bazemore, Kent" shirtnumber="24" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="1593946" name="Bey, Saddiq" shirtnumber="41" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="1322540" name="Brown, Charles" shirtnumber="76" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="996293" name="Bembry, DeAndre'" shirtnumber="95" substitute="false" team="1">
<specificcontracts>
<specificcontract value="2-way-contract"/>
</specificcontracts>
</player>
<player id="607898" name="Capela, Clint" shirtnumber="15" substitute="true" team="1"/>
<player id="1316758" name="Brown, Chaundee" shirtnumber="45" substitute="true" team="1"/>
<player id="607560" name="Carter, Vince" shirtnumber="56" substitute="true" team="1"/>
<player id="996297" name="Brown, Jaylen" shirtnumber="7" substitute="false" team="2"/>
<player id="1930078" name="Brissett, Oshae" shirtnumber="12" substitute="false" team="2"/>
<player id="996319" name="Brogdon, Malcolm" shirtnumber="13" substitute="false" team="2"/>
<player id="2218516" name="Davison, JD" shirtnumber="20" substitute="false" team="2"/>
<player id="1595370" name="Banton, Dalano" shirtnumber="45" substitute="false" team="2"/>
<player id="1169046" name="Edwards, Carsen" shirtnumber="4" substitute="true" team="2"/>
<player id="1286462" name="Fernando, Bruno" shirtnumber="28" substitute="true" team="2"/>
<player id="608288" name="Fournier, Evan" shirtnumber="94" substitute="true" team="2"/>
<player id="1829084" name="Fall, Tacko" shirtnumber="99" substitute="true" team="2"/>
</lineups>

(ID: 239) Include basketball bonus attribute

Enabling this setting allows a new dynamic Bonus attribute to be sent with each event for NBA matches covered by the External Feed. This Boolean parameter is activated when one of the teams commits the 5th foul in a given quarter, triggering a bonus situation for the opposing team.

XML example

<event type="110" stime="1739328213300" side="home" mtime="34:12" info="[T1] have possession" id="2238439004" uuid="07525db7-9e76-4b32-9d42-0f6b71b5df50" matchscore="59:104" remainingtimeperiod="00:00" periodnumber="3" bonushome="1" bonusaway="0" matchstatus="THIRD_QUARTER"/> 

(ID: 240) Include possible free throw events

Enabling this setting allows events 2396 (Possible free throws) and 2397 (Free throws not confirmed) to be sent for NBA matches covered by the External Feed.