STATS LLC
NBA XML Documentation
August 6, 2008
NBA_LIVE.XML
Contents: Score and time remaining. Contains one record for every game being played that day. New days begin at 11:30 Eastern Time. Updates: About once every 30 seconds. Definitions/Details: gamestate-status: “Pre-game”, “In-Progress”, “Final” or “Postponed”. gamestate-quarter: 1-4 during regulation, 5 for the first overtime, 6 for the second, etc. The possible event-type values for the „last-play‟ node are as follows:
Event Details
Event ID
1
Event Description Details
Detail ID
10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 8 40 41 42 43 44 45 46 47 48 49 50 51 52 53
Event Description
Free Throw Made
Detail Description
Free Throw 1 of 1 Free Throw 1 of 2 Free Throw 2 of 2 Free Throw 1 of 3 Free Throw 2 of 3 Free Throw 3 of 3 Free Throw Technical Free Throw Clear Path Free Throw Flagrant 1 of 2 Free Throw Flagrant 2 of 2 Free Throw Flagrant 1 of 1 Free Throw Technical 1 of 2 Free Throw Technical 2 of 2 Free Throw Clear Path 1 of 2 Free Throw Clear Path 2 of 2 Free Throw 1 of 1 Free Throw 1 of 2 Free Throw 2 of 2 Free Throw 1 of 3 Free Throw 2 of 3 Free Throw 3 of 3 Free Throw Technical Free Throw Clear Path Free Throw Flagrant 1 of 2 Free Throw Flagrant 2 of 2 Free Throw Flagrant 1 of 1 Free Throw Technical 1 of 2 Free Throw Technical 2 of 2 Free Throw Clear Path 1 of 2 Free Throw Clear Path 2 of 2 Slam Dunk Shot Layup Shot Running Layup Shot Driving Layup Shot Alley Oop Layup Shot Reverse Layup Shot Jump Shot Running Jump Shot Turnaround Jump Shot Dunk Shot Driving Dunk Shot Running Dunk Shot Reverse Dunk Shot Alley Oop Dunk Shot Tip Shot
2
Free Throw Missed
3
Field Goal Made
Confidential
Page 1 of 10 NBA XML
STATS LLC
NBA XML Documentation
54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 8 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
August 6, 2008
4
Field Goal Missed
Running Tip Shot Hook Shot Running Hook Shot Driving Hook Shot Turnaround Hook Shot Finger Roll Shot Running Finger Roll Shot Driving Finger Roll Shot Turnaround Finger Roll Shot Fade Away Jump Hook Follow Up Dunk Bank Shot Hook Bank Shot Finger Roll Layup Shot Putback Layup Shot Driving Reverse Layup Shot Running Reverse Layup Shot Driving Finger Roll Layup Shot Running Finger Roll Layup Shot Driving Jump Shot Floating Jump Shot Pull Up Jump Shot Step Back Jump Shot Pull Up Bank Jump Shot Driving Bank Jump Shot Fade Away Bank Jump Shot Running Bank Jump Shot Turnaround Bank Jump Shot Turnaround Fade Away Jump Shot Putback Jump Shot Driving Slam Dunk Shot Reverse Slam Dunk Shot Running Slam Dunk Shot Putback Reverse Dunk Shot Putback Slam Dunk Shot Driving Bank Hook Shot Jump Bank Hook Shot Running Bank Hook Shot Turnaround Bank Hook Shot Unknown Shot No Shot Slam Dunk Shot Layup Shot Running Layup Shot Driving Layup Shot Alley Oop Layup Shot Reverse Layup Shot Jump Shot Running Jump Shot Turnaround Jump Shot Dunk Shot Driving Dunk Shot Running Dunk Shot Reverse Dunk Shot Alley Oop Dunk Shot Tip Shot Running Tip Shot Hook Shot Running Hook Shot Driving Hook Shot Turnaround Hook Shot Finger Roll Shot Running Finger Roll Shot Driving Finger Roll Shot Turnaround Finger Roll Shot
Confidential
Page 2 of 10 NBA XML
STATS LLC
NBA XML Documentation
63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 5 6 7 Offensive Rebound Defensive Rebound Turnover NA NA 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 1 2
August 6, 2008
8
Foul
Fade Away Jump Hook Follow Up Dunk Bank Shot Hook Bank Shot Finger Roll Layup Shot Putback Layup Shot Driving Reverse Layup Shot Running Reverse Layup Shot Driving Finger Roll Layup Shot Running Finger Roll Layup Shot Driving Jump Shot Floating Jump Shot Pull Up Jump Shot Step Back Jump Shot Pull Up Bank Jump Shot Driving Bank Jump Shot Fade Away Bank Jump Shot Running Bank Jump Shot Turnaround Bank Jump Shot Turnaround Fade Away Jump Shot Putback Jump Shot Driving Slam Dunk Shot Reverse Slam Dunk Shot Running Slam Dunk Shot Putback Reverse Dunk Shot Putback Slam Dunk Shot Driving Bank Hook Shot Jump Bank Hook Shot Running Bank Hook Shot Turnaround Bank Hook Shot Unknown Shot No Shot NA NA Bad Pass Lost Ball Out of Bounds Traveling Foul Double Dribble Discontinue Dribble 3 Second Violation 5 Second Violation 10 Second Violation Shot Clock Turnover Inbound Turnover Backcourt Turnover Illegal Pick Offensive Goaltending Isolation Violation Lane Violation Jump Ball Violation Kicked Ball Violation Illegal Assist Turnover Palming Turnover Post Up Turnover Lost Ball Out of Bounds Swinging Elbows Turnover Illegal Screen Turnover Stepped Out of Bounds 8 Second Violation Stolen Pass Turnover Enter Basket from Below Personal Shooting
Confidential
Page 3 of 10 NBA XML
STATS LLC
NBA XML Documentation
3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 1 2 3 4 5 6 NA 1 2 3 4 NA 1 2 3 4 NA NA NA Loose Ball Offensive Inbound Away From Play Elbow Punching Clear Path Double Personal Technical Non Supported Technical Hanging Technical Flagrant Type 1 Flagrant Type 2 Double Technical Illegal Defense Delay Technical Taunting Technical Player Control Foul Flagrant Charging Delay of Game Illegal Defense Defensive Goaltending Lane Jump Ball Kicked Ball NA Regular Short Official TV Official NA Second Technical Second Flagrant Type 1 First Flagrant Type 2 Other NA NA NA
August 6, 2008
9
Violation
10 11
Substitution Timeout
12 13
Jump Ball Ejection
14 15 19
Start Period End Period Game Over
File Update Type: Live
XML
one node for each game
Confidential
Page 4 of 10 NBA XML
STATS LLC
NBA XML Documentation
August 6, 2008
one entry for each period same as visiting team
Node DATE
Name year month date day
Type Integer Integer Integer Integer
Example 2001 3 20 2
Comments
Day of Week (1 = Monday…7=Sunday) military time no leading zero Always “Eastern” Hours difference between UTC and timezone in this XML. Additional minutes difference between UTC and timezone in this XML. Seasons referenced by first
TIME hour minute second timezone utc-hour Integer Integer Integer String Integer 1 8 22 Eastern -5
utc-minute
Integer
00
SEASON season Integer 2001
Confidential
Page 5 of 10 NBA XML
STATS LLC
NBA XML Documentation
August 6, 2008
year of season. That is, the 2001-02 basketball season is displayed as “2001.” Game Time
TIME hour minute timezone utc-hour Integer Integer String Integer 12 30 Eastern -5
military time no leading zero Always “Eastern” Hours difference between UTC and timezone in this XML. Additional minutes difference between UTC and timezone in this XML.
utc-minute
Integer
00
LOCAL-GAMEDATE year month date day year LOCAL-TIME hour minute GAMECODE code Integer 2001032029 Ten digits: YYYYMMDDTT where TT = team ID of home team. Integer Integer 1 8 military time no leading zero Integer Integer Integer Integer Integer 2001 3 20 2 2001 Day of Week (1 = Monday…7=Sunday)
global-id GAMETYPE id
Integer Integer
810463 1 1 = Regular Season 2 = Post Season 3 = Pre Season 4 = All-Star
type STADIUM name city state country
String String String String String
Regular Season United Center Chicago Illinois United States
Confidential
Page 6 of 10 NBA XML
STATS LLC
global-id id COVERAGE level GAMESTATE status status-id quarter minutes seconds segmentnumber
NBA XML Documentation
Integer Integer Integer 1414 1 1
August 6, 2008
1 = NBA Feed 2 = Stats reporter feed “In-Progress”, “Final”, “Pre-Game”, “Postponed” “” if not In-Progress. “5” for first OT, “6” for 2nd, etc. Only appears if In-Progress Only appears if In-Progress Current period number or final periods played for Final games. “true” or “false” – if currently playing the period. Once a period ends, active-state = “false.” When the next one begins, active-state=”true” and the period is incremented. If there is no time left on the clock in a period, but active-state=”true”, the period has NOT yet ended. “5” for first OT, “6” for second OT, etc.
String Integer Integer Integer Integer Integer
Final 1 2 10 20 3
active-state
Boolean
true
LAST-PLAY quarter timeminutes timeseconds seq-number Integer Integer Integer Integer 4 11 12 1 A number that shows the sequence of each play within the game Main player in play
first-name1 last-name-1 globalplayer-id-1
String String Integer
Samuel Dalembert 654444
Any player without a preexisting ID will receive a temporary ID in the following format: 99XXXXXYY where XXXXX = team id and YY
Confidential
Page 7 of 10 NBA XML
STATS LLC
NBA XML Documentation
August 6, 2008
is uniform number.
player-id-1
Integer
3534
Any player without a preexisting ID will receive a temporary ID in the following format: 99XXXXXYY where XXXXX = team id and YY is uniform number.
globalteam-code1 team-code1 team-alias1 first-name2 last-name-2 globalplayer-id-2
Integer
4322
Integer String String String Integer
20 Phi Steven Hunter 654333
The team to which the main player in the play belongs 2 or 3 letter team abbreviation Second player in play
player-id-2
Integer
3525
Any player without a preexisting ID will receive a temporary ID in the following format: 99XXXXXYY where XXXXX = team id and YY is uniform number. Any player without a preexisting ID will receive a temporary ID in the following format: 99XXXXXYY where XXXXX = team id and YY is uniform number.
globalteam-code2 team-code2 team-alias2 first-name3 last-name-3 globalplayer-id-3
Integer
4322
Integer String String String Integer
20 Phi Andrew Bogut 645555
The team to which the player belongs 2 or 3 letter team abbreviation Third player in play
Any player without a preexisting ID will receive a temporary ID in the following format: 99XXXXXYY where XXXXX = team id and YY
Confidential
Page 8 of 10 NBA XML
STATS LLC
NBA XML Documentation
August 6, 2008
is uniform number.
player-id-3
Integer
3927
Any player without a preexisting ID will receive a temporary ID in the following format: 99XXXXXYY where XXXXX = team id and YY is uniform number.
globalteam-code3 team-code3 team-alias3 points-type event-id eventdescription detail-id detaildescription distance x-shotcoord y-shotcoord fastbreak in-paint
Integer
3434
Integer String Integer Integer String Integer String Integer Integer Integer Boolean Boolean
15 Mil 3 4 Field Goal Missed 40 Layup Shot 6 -4.5 4.3 false true false false 12 6 28 33 5 4
The team to which the player belongs 2 or 3 letter team abbreviation Whether the play is worth 1, 2, or 3 points
secondBoolean chance off-turnover Boolean playerscore player-fouls visitorscore home-score Integer Integer Integer Integer
visitor-fouls Integer home-fouls Integer
Points for player in the game Fouls for player in the game Points for visiting team in the game Points for home team in the game Fouls for visiting team in the game Fouls for home team in the game
Confidential
Page 9 of 10 NBA XML
STATS LLC
textualdescription
NBA XML Documentation
String Jump Ball: Samuel Dalembert vs. Andrew Bogut – Steven Hunter gains possession. Knicks NY
August 6, 2008
Textual description of play
TEAM-NAME name alias TEAM-CITY city TEAM-CODE global-id id RECORD Integer Integer 312411 21 1 or 2 digit integer During the Playoffs, the W/L record contains the record of each team for the current Playoff series. wins losses pct LINESCORE score QUARTER quarter score team-fouls Integer Integer Integer 1 22 33 “5” for first OT, “6” for second OT, etc. score in that period only. Team fouls in that quarter Integer 24 Overall score for game Integer Integer Real 1 1 .500 String New York String String Team nickname 2 or 3-letter team abbreviation
Confidential
Page 10 of 10 NBA XML