Snooker
Sport specific information for snooker.
Match statuses for snooker
0
NOT_STARTED
Not started yet
-
21
IN_PROGRESS
The match is in progress
-
30
PAUSE
The match is paused
-
445
SESSION_BREAK
Session break
-
100
ENDED
The match has ended
-
93
WALKOVER1
The home team won the match by walkover
-
94
WALKOVER2
The away team won the match by walkover
-
95
RETIRED1
The away team won because the home team retired
-
96
RETIRED2
The home team won because the away team retired
-
97
DEFAULTED1
The away team won because the home team defaulted
This match status is only sent if the corresponding XML configuration is enabled.
98
DEFAULTED2
The home team won because the away team defaulted
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 snooker
110
Player at table
Information about which player is at the table.
XSA (DC)
-
-
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.
XSA (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.
XSA (DC)
-
-
1013
Match status
Sent when the status of the match changes.
XSA (DC)
See the above table for available match statuses in snooker
-
1015
Free text
Used for any kind of additional information during the match. Example: "Match interrupted due to flood light break down", etc..
XSA (DC)
-
-
1022
Who will strike first
Information about what player has the first strike.
XSA (DC)
-
-
1036
Time start / stop
Triggered when the clock is started or stopped.
XSA (DC)
Possible values:
1 = Time started
0 = Time stopped
-
1044
Deleted event alert
Manual removal of an event.
XSA (DC)
Id of event that was deleted
-
1102
Coverage status
Sent when the coverage status for the match changes
XSA (DC)
Possible values:
0 = Covered
1 = Coverage abandoned
2 = Match will not be covered
-
1136
Best of frames
Best of frames
XSA (DC)
Number of frames
Number of red balls.
1137
Snooker score change
Sent when the score in the snooker match changes
XSA (DC)
Snooker score change type. Possible values:
0 = Standard
1 = Break
2 = Frame
3 = Session
4 = Match
Type of frame win (this attribute is only relevant for score change frame). Possible values:
0 = Standard
1 = Late opponent
2 = Technical problem
3 = Three fouls missed
4 = Opponent concedes
5 = Ungentlemanly conduct
6 = Other
1139
Unscheduled break
Sent when an unscheduled break happens.
XSA (DC)
Reason for break. Possible values:
0 = Other reason
1 = Technical problem
2 = Player injury
3 = Match pulled off
-
1169
Ball pot
Ball pot
XSA (DC)
Points scored
Number of red balls on the table.
1170
Free ball
Free ball event
XSA (DC)
Points scored
-
1171
Snooker foul
Snooker foul event occurs
XSA (DC)
Points scored
-
1173
Rerack
Used when the balls on the table are being reracked
XSA (DC)
-
-
1174
Remove ball
Ball removed in snooker
XSA (DC)
Number of red balls left on the table.
Least valuable color left on table.
1175
Add ball
Ball added in snooker
XSA (DC)
Number of red balls left on the table.
Least valuable color left on table.
1186
Table ready
Snooker table is ready
XSA (DC)
-
-
1187
Play about to start
Sent when the play will (re)start in a couple of minutes.
XSA (DC)
-
-
1203
Free ball awarded
Free ball has been awarded to player
XSA (DC)
-
-
2349
Shot Taken
Information that the player has taken a shot and the balls are in motion.
XSA (DC)
description: equipment in use
values:
0 = none
1 = equipment in use
-
2350
Shot Ended
Sent after Shot Taken, indicates that all the balls have stopped.
XSA (DC)
-
-
2351
Shot To Be Retaken
Information that shot needs to be retaken by the player after a foul and a miss. The '2357 Snooker' event is sent afterwards.
XSA (DC)
-
-
2354
Warning
Information about a verbal warning form the referee.
XSA (DC)
description: warning reason
values:
0 = unknown
1 = second miss with a clear sight of the ball
2 = disciplinary
-
2355
Re-spotted Black
Information about the re-spotted black event to resolve a tie in a frame.
XSA (DC)
-
-
2356
Possible Snooker
Information about a possible snooker in the current position.
XSA (DC)
-
side
description: snookered player
values:
home
away
-
2357
Snooker
Information about a snooker. Per official definition: "The cue-ball is snookered when a direct stroke in a straight line to every ball on is wholly or partially obstructed by a ball or balls not on. If one or more balls on can be hit at both extreme edges free of obstruction by any ball not on, the cue-ball is not snookered." Player can be considered to be snookered until the next '2359 Shot Taken' event is sent.
XSA (DC)
-
side
description: snookered player
values:
home
away
-
2358
Snooker Not Confirmed
Possible snooker not confirmed.
XSA (DC)
-
side
description: snookered player
values:
home
away
-
Sport specific XML elements and attributes
This section explains what elements / attributes one can expect for snooker matches in addition to the standard elements and attributes, and what the meaning of those elements and attributes is.
Attributes in <match> element
<match betstatus="BETSTOP" connectionstatus="0" device="3" extrainfo="0" feedtype="full" matchid="10115538" matchtime="0:00:00" st1id="
25061" st2id="22433" start="1464869040000" t1id="1308930" t1name="TRUMP, JUDD" t2id="1308934" t2name="BINGHAM, STUART"
timerunning="0">
...
</match>XML elements and attributes definition
Match
firstserve
Which player has first serve of match.
Integer
numberofsets
How many sets are being played in the match.
Integer
Elements in <match> element
<match betstatus="BETSTOP" connectionstatus="0" device="3" extrainfo="0" feedtype="full" matchid="10115538" matchtime="0:00:00" st1id="
25061" st2id="22433" start="1464869040000" t1id="1308930" t1name="TRUMP, JUDD" t2id="1308934" t2name="BINGHAM, STUART"
timerunning="0">
<status id="0" name="NOT_STARTED" start="0"/>
<score t1="0" t2="0" type="match"/>
<score t1="0" t2="0" type="frame"/>
<score t1="0" t2="0" type="break"/>
<possession team="home"/>
<tournament id="11830" name="Premier Snooker League, Final round"/>
<category id="193" name="England"/>
<sport id="19" name="Snooker"/>
<events/>
</match>XML elements and attributes definition
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:
Ball pot (1169), Free ball (1170), Snooker foul (1171), Snooker score change (1137), Rerack (1173)
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:
match
frame
frame1
frame2
...
frame 34
frame35
break
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)
team
Which team has possession.
String. Possible values:
"home"
"away"
Attributes in <event> element
<match matchid="9474387" ... >
<events>
<event breakscore="0:57" extrainfo="7" extrainfosnooker="7" framenumber="7" framescore="0:61" id="644572117" info="7 points (Black)"
matchscore="3:3" mtime="2:17:32" side="away" stime="1464953573333" type="1169"/>
</events>
</match>XML attributes definition
<match matchid="9474387" ... >
<events>
<event breakscore="0:57" extrainfo="7" extrainfosnooker="7" framenumber="7" framescore="0:61" id="644572117" info="7 points (Black)"
matchscore="3:3" mtime="2:17:32" side="away" stime="1464953573333" type="1169"/>
</events>
</match>event
extrainfo
Attribute containing additional information about the event.
Long
extrainfosnooker
Attribute containing additional information about the event.
String
matchscore
Score for current match.
String. Format: "[home]:[away]" Example: "1:0"
framenumber
Frame number in the match.
Integer
framescore
Frame score.
String. Format: "[home]:[away]" Example: "1:0"
breakscore
Break score.
String. Format: "[home]:[away]" Example: "1:0"
maxbreakframe
Highest break in the current frame.
Integer
maxbreakmatch
Highest break in the current match.
Integer
reds
Number of Reds remaining on the table.
Integer
pointsremaining
Points remaining on the table.
Integer
pointsuntilsnookerneeded
Points until snooker is needed to win the frame.
Integer
possiblebreak
Highest possible break in the current situation.
Integer
XML configurations for snooker
(ID: 121) Include match status defaulted in snooker
Enabling this setting will allow the system to send match statuses DEFAULTED1 and DEFAULTED2.
Last updated
Was this helpful?