This web socket endpoint returns the live stats data per fight. Once a fight commences the live information will visible and you'll be able to view the live stats
Process for connecting to the web socket endpoints
Connect to the SSL websocket address
Send JSON packet containing API token
Receive response indicating that connection is authorised (or a response indicating why the connection cannot be made)
Receive heartbeat packets every 10 seconds to verify the connection is live
Receive data packets
Once you have sent the API token, any further data that you send over the connection will be ignored.
Request Parameters
Parameter
Type
Purpose
startPosition
integer
The position in the stream that you want to start from.
Each packet in the stream has a sequence number ('seqNum'), where 1 is the first packet in the stream. By default the stream will start from the beginning.
This is useful if you get disconnected from a stream and need to reconnect. When reconnecting, if you specify the seqNum of the last packet you received + 1, then you can pick up where you left off without need to reprocess all the events already received.
Response Model
Each stats packet sent over the websocket has the following format:
Field Name
Type
Description
seqNum
integer
The sequence number of the packet
timestamp
string
ISO8601 datetime string representing the time the packet was generated
fighters
object
Name and fighter ID for the red and blue fighters
roundStats
string
A breakdown of the full stat summary for each fighter in each round
fightStats
object
A full stat summary for each fighter for the overall fight
fightCardId
integer
The ID of the fight card
currentRound
integer
Which round is currently in progress
fightId
integer
The ID of the fight in our database
maxRounds
integer
The maximum number of rounds in this fight; normally either 3 or 5
accolade
string
The accolade of the fight. Optional.
referee
string
The full name of this fight’s referee
weightclass
string
The fight’s weight class name
status
string
currentRoundTime
string
The current round time, counting down from 5 minutes at the start
Fighter object
Object broken down into blue and red team
Field Name
Type
Description
name
string
fighter name
fighterId
integer
The ID of the fighter to which these stats refer
ufcFighterId
string
will be null
pflFighterId
string
The PFL fighter ID of the fighter to which these stats refer
fightStats objects
Object broken down into blue and red team
Field Name
Type
Description
TIP
object
Time in Position stats
grappling
object
Breakdown of stats in grappling positions
strikes
object
Breakdown of stats in strikes positions
fighterId
integer
The ID of the fighter to which these stats refer
ufcFighterId
string
will be null
pflFighterId
string
The PFL fighter ID of the fighter to which these stats refer
TIPS (Time In Positions) object
Field Name
Type
Description
backControlTime
string
Time spend in backControlTime positions
controlTime
string
Time spend in controlTime positions
distanceTime
string
Time spend in distanceTime positions
groundControlTime
string
Time spend in groundControlTime positions
groundTime
string
Time spend in groundTime positions
guardControlTime
string
Time spend in guardControlTime positions
halfGuardControlTime
string
Time spend in halfGuardControlTime positions
miscGroundControlTime
string
Time spend in miscGroundControlTime positions
mountControlTime
string
Time spend in mountControlTime positions
neutralTime
string
Time spend in neutralTime positions
sideControlTime
string
Time spend in sideControlTime positions
standingTime
string
Time spend in standingTime positions
grappling object
Field Name
Type
Description
reversals
object
Object contains the number of attempts reversals and landed reversals
standups
object
Object contains the number of attempts standups and landed standups
submissions
object
Object contains the number of attempts submissions and landed submissions
takedowns
object
Object contains the number of attempts takedowns and landed takedowns
roundStats object
Stats are also availble at round level
Field Name
Type
Description
Round number
object
Each round is broken down by red and blue corner. Contains TIP, grappling and strikes per round. Please view the revelent object tables for more information.
Sample Response:
Here’s a sample of the output we have for fight, Patrick Ocheme vs. Abdul Razac Sankara; this is one packet from near the end of the fight. Each packet contains a full new set of stats for the fight so far, replacing the calculated stats of the last packet. We only send a new packet (with a new sequence number) when the stats have changed.
