NHL Real-Time Scoring System Feed


Overview: Each arena transmits a data file to the NHL and SportsTicker every time a goal, shot or penalty is scored. In the absence of these events, data is transmitted every two minutes. The data is transmitted in one file, containing the following seven record types: Game Information, Roster, Event, Goal, Goalie Shift, Summary and Final. The records in this file are cumulative, with new records appended at the bottom of the file. Records are never deleted or changed. Instead a record version number is either incremented to indicate a change to a prior record or set to –1 to denote a deletion.

All records are comma separated. Text fields do not have quotations around it.



Record Definition
Record TypeName of RecordDescription
I Game InformationOne record defining the teams, game time, arena and on-ice officials
RRosterDefines roster data for each player
EEventContains each event, except for goals
GGoalDenotes each goal scored
TGoalie ShiftDefines each shift for a goalie. There will be a minimum of 3 goalie records (1 for each period) for each team
FFinalContains post-game information such as 3 stars, winning/losing goalie & attendance
SSummarySummarized statistics for each player including time on ice, number of shifts, goals, shots by period, hits, faceoffs, penalties, etc.



Game Information - Field Definition
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"I" = Game info record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Range: 1 to 9999
GAME_RECORD_VERGame Record Versioninteger4Range: 0 to 9999 (Incremented if change; -1 if delete)
VIS_TEAM_ABBREVVisiting team abbreviationchar3ex: N.J
VIS_TEAM_NAMEFull name of visiting teamchar30ex: NEW JERSEY DEVILS
HOME_TEAM_ABBREVHome team abbreviationchar3ex: NYR
HOME_TEAM_NAMEFull name of home teamchar30ex: NEW YORK RANGERS
SCHEDULED_TIMEScheduled start time (local time)char8HH:MM:SS
TIME_ZONETime zonechar2ET, CT, MT, PT
ARENAArenachar50ex: Madison Square Garden
REFEREE1Name of 1st refereechar30Upper and lower case
REFEREE2Name of 2nd referee (if any)char30Upper and lower case
LINESMAN1Name of 1st linesmanchar30Upper and lower case
LINESMAN2Name of 2nd linesmanchar30Upper and lower case
RECENDEnd of record indicatorchar1"^" ( ASCII 94)



Roster - Field Defintion
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"R" = Roster Info record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Ranges 1 to 9999
PLAYER_TEAMPlayer Team abbreviationchar3NHL team abbreviation code
PLAYER_NUMPlayer jersey numberchar2Ranges 00 to 99
ROSTER_RECORD_VERRoster Record Versioninteger4Range: 0 to 9999 (Incremented if change; -1 if delete)
PLAYER_FNAMEPlayer first namechar30Upper case
PLAYER_LNAMEPlayer last namechar30Upper case
PLAYER_POSPlayer's positioninteger21=goalie, 2=defenseman, 3=forward, 4=left wing, 5=right wing, 6=center, 7=alternate, 8=unknown
CAPTAINCaptain or Alternate Captainchar1C=Captain, A=Alternate, N=Neither
STARTERStarted game on icechar1Y=Yes, N=No
SCRATCHEDScratched?char1Y=Scratched, N=Not
YTD_GOALSYear-to-date goals (prior to current game) – not updated during gameinteger3-1 to 999 (-1 indicates number unknown)
YTD_ASSISTSYear-to-date assists (prior to current game) – not updated during gameinteger3-1 to 999 (-1 indicates number unknown)
RECENDEnd of record indicatorchar1"^" ( ASCII 94)



Event - Field Definition
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"E" = Event record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Ranges 1 to 9999
PERIODCurrent Periodinteger1Ranges 0 to 9
GAME_TIMETime in period (as opposed to time remaining on clock)char5MM:SS
VIS_SCOREVisiting team scoreinteger2Ranges 0 to 99
HOME_SCOREHome team scoreinteger2Ranges 0 to 99
EVENT_NUMBERUnique event number (not sequential)char10Format XXX1234567 (XXX=Home Team)
EVENT_NUMBER_VEREvent number versioninteger4Range: 0 to 9999 (to accommodate changes)
LOCAL_TIMEWall clock time (local)char8HH:MM:SS
EVENT_GAME CODEEvent Game codeinteger4Range: 501 to 599

502=Faceoff, 503=Hit, 504=Turnover, 506=Shot, 507=Miss, 508=Block, 509=Penalty, 516=Stoppage

REASON_TYPEReason or Typeinteger4Ranges 0 (not applicable) or 601 to1102

See Reason Type table

(6??=Stoppage reason: 8??=shot type, 10??=missed shot reason, 11??=blocked shot type), 1401=takeaway, 1402=giveaway.

If event_game_code = 509 (penalty), use penaltycodes table

X_COORX-Coordinate of play (feet from center ice based on PLAYER_1_TEAM)integer3Ranges -100 to +100
Y_COORY-Coordinate of play (feet from center ice based on PLAYER_1_TEAM)integer3Ranges -100 to +100
STRENGTHStrength of PLAYER_1 teaminteger3Ranges 701-703 (701=Even, 702=PP, 703=SH)
PLAYER_1_TEAMPlayer 1 Team abbreviationchar3NHL team abbreviation code
PLAYER_1Player 1 Jersey number

Player who shot, missed shot, blocked shot, won face-off, hit a player, gave puck away, took puck away or was assessed a penalty

char200 to 99
PLAYER_2_TEAMPlayer 2 Team abbreviationchar3NHL team abbreviation code if applicable
PLAYER_2Player 2 Jersey number

Player who loses faceoff or drew penalty

char200 to 99; -1 if no reactor; blank if N/A
PLAYER_SERVEDPlayer who served penalty Jersey number if assessed player is not servingchar200 to 99; -1 if player assessed is serving
SPECIAL_SHOT_INFOSpecial shot typeinteger4Ranges 901 to 902

901=Regular Shot, 902=Penalty Shot

SHOT_LENGTHLength of Shot in feetinteger30 to 240
GOALIEGoalie in net at time of shotchar200 to 99
RECENDEnd of record indicatorchar1"^" ( ASCII 94)



Goal – Field Definition
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"G" = Goal record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Ranges 1 to 9999
PERIODCurrent Periodinteger1Ranges 0 to 9
GAME_TIMETime in period (as opposed to time remaining on clock)char5MM:SS
VIS_SCOREVisiting team scoreinteger2Ranges 0 to 99
HOME_SCOREHome team scoreinteger2Ranges 0 to 99
EVENT_NUMBERUnique event number (not sequential)char10Format XXX1234567 (XXX=Home Team)
EVENT_NUMBER_VEREvent number versioninteger4Range: 0 to 9999 (to accommodate changes)
LOCAL_TIMEWall clock time (local)char8HH:MM:SS
EVENT_GAME CODEEvent Game codeinteger4505 (Goal)
SHOT_TYPEShot typeinteger4Ranges 801 to 806

801=Slap, 802=Snap, 803=Wrist, 804=Wrap, 805=Tip-In, 806=Backhand

X_COORX-Coordinate of play (feet from center ice based on PLAYER_1_TEAM)integer3Ranges -100 to +100
Y_COORY-Coordinate of play (feet from center ice based on PLAYER_1_TEAM)integer3Ranges -100 to +100
STRENGTHStrength of PLAYER_1 teaminteger3Ranges 701-703

701=Even, 702=PP, 703=SH

SPECIAL_SHOT_INFOSpecial shot typeinteger4Ranges 901 to 903

901=Regular, 902=Penalty Shot, 903=Empty Net

SCORING_TEAMGoal Scorer Team abbreviationchar3NHL team abbreviation code
GOAL_SCORERGoal Scorer Jersey numberchar200 to 99
ASSIST_11st Assist Jersey numberchar200 to 99 (-1 if no first assist)
ASSIST_22nd Assist Jersey numberChar200 to 99 (-1 if no second assist)
GOALIEOpposing goalie Jersey numberchar200 to 99
VIS_PLAYERS_ON_ICEVisiting players on ice when goal was scored (separated by colons)

ex: ,33:3:23:2:5,

string20Players jersey numbers
HOME_PLAYERS_ON_ICEHome players on ice when goal was scored (separated by colons)

ex: ,33:3:23:2:5,

string20Players jersey numbers
SHOT_LENGTHLength of Shot in feetinteger30 to 240
RECENDEnd of record indicatorchar1"^" ( ASCII 94)



Goalie TOI Shift - Field Definition
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"T" = Goalie TOI/shift record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Ranges 1 to 9999
PERIODCurrent Periodinteger1Ranges 0 to 9
VIS_SCOREVisiting team scoreinteger2Ranges 0 to 99
HOME_SCOREHome team scoreinteger2Ranges 0 to 99
EVENT_NUMBERUnique event numberchar10Format XXX1234567 (XXX=Home Team)
PLAYER_SHIFT_VERPlayer Shift Version Numberinteger4Range: 0 to 9999 (to accommodate changes)
PLAYER_TEAMPlayer Team abbreviationchar3NHL team abbreviation code
PLAYER_NUMGoalie sweater numberchar200 to 99
LOCAL_TIMEWall clock time (local0char8HH:MM:SS
SHIFT_START_TIMETime in period shift startedchar5MM:SS
SHIFT_END_TIMETime in period shift endedchar5MM:SS
RECENDEnd of record indicatorchar1"^" ( ASCII 94)



Final Record Field Definition
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"F" = Final record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Ranges 1 to 9999
FINAL_RECORD_VERFinal Record Versioninteger4Range: 0 to 9999 (to accommodate changes)
PERIODTotal periods for the gameinteger1Ranges 0 to 9
VIS_SCOREVisiting team scoreinteger2Ranges 0 to 99
HOME_SCOREHome team scoreinteger2Ranges 0 to 99
ATTENDANCETotal Attendanceinteger5Ranges 0 to 99999
START_TIMETime game started (local time)char5HH:MM
END_TIMETime game ended (local time)char5HH:MM
1ST_STAR_TEAM1st Star - Team abbreviationchar3NHL team abbreviation code
1ST_STAR1st Star Player Jersey numberchar200 to 99
2ND_STAR_TEAM2nd Star - Team abbreviationchar3NHL team abbreviation code
2ND_STAR2nd Star Player Jersey numberchar200 to 99
3RD_STAR_TEAM3rd Star - Team abbreviationchar3NHL team abbreviation code
3RD_STAR3rd Star Player Jersey numberchar200 to 99
WINNING_TYING_TEAMWinning/Tying Team Abbreviationchar3NHL team abbreviation code
WINNING_TYING_GOALIEWinning/Tying teams Goalie in net when winning/tying goal is scoredchar200 to 99
LOSING_TYING_TEAMLosing/Tying Team Abbreviationchar3NHL team abbreviation code
LOSING_TYING_GOALIEOpposing goalie in net when winning/tying goal is scoredchar200 to 99
RECENDEnd of record indicatorchar1"^" ( ASCII 94)



Summary Statistics Record Field Definition
NameDescriptionTypeMax SizeContents
RECTYPRecord typechar1"S" = Summary Stats record
DATEGame datechar10MM/DD/YYYY
GAME_TYPEPreseason, Regular season or Playoffsinteger11=Preseason, 2=Regular Season, 3=Playoffs
GAME_NUMGame numberinteger4Ranges 1 to 9999
PERIODCurrent Periodinteger1Ranges 0 to 9
GAME_TIMEGame time (time into period)char5MM:SS or FINAL
VIS_SCOREVisiting team scoreinteger2Ranges 0 to 99
HOME_SCOREHome team scoreinteger2Ranges 0 to 99
PLAYER_TEAMPlayer Team abbreviationchar3NHL team abbreviation code
PLAYER_NUMPlayer jersey numberchar2Ranges 00 to 99
PLUS_MINUSPlus/minusinteger3Range -99 to +99, 0=Even
TOTAL_TOITotal Time On Icechar5MMM:SS
PP_TOITotal Time on ice on powerplaychar5MMM:SS
SH_TOITotal Time on ice short handedchar5MMM:SS
EV_TOITotal Time on ice even strengthchar5MMM:SS
NUM_SHIFTSNumber of shiftsinteger3Range 0 to 99
NUM_GOALSNumber of goalsinteger2Range 0 to 99
YTD_GOALSNumber of goals to date (including this game)integer3-1 to 999 (-1 indicates number unknown)