Fight Actions
This web socket endpoint returns the detailed action data per fight. You will need to make a connection for each fight once. This endpoint is in conjunction with the Live Events REST endpoint – when a fight starts it will be included in the response to the /liveevents endpoint, and at that point you should commence connecting to the web socket for that fight’s action feed
Endpoint URL
wss://dde-streams.data.imgarena.com/mma/fights/{id}/actions
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 action packet sent over the websocket has the following format:
Field Name
Type
Description
fighters
object
Name and fighter ID for the red and blue fighters respectively
timestamp
string
ISO 8601 timestamp representing when this action occurred
roundTime
string
Time left on the clock when this action occurred
result
string
Optional. Indicates whether or not the attempted action was successful. Possible values are successful or unsuccessful
eventElementType
string
The type of event we’re reporting, such as a strike, takedown attempt, or submission attempt. See the eventElementType table for the possible event types.
id
integer
A unique ID associated with the action
seqNum
integer
The sequence number of the packet in the feed
fighters
string
Optional. Which fighter performed the action, if relevant. Possible values are Red and Blue.
details
object
Optional. Provides detailed information about the nature of the action. See the details table.
sendType
string
Identifies if the packet is either a - "new", "deleted" or "correction".
new = new actionId
correction = existing actionId which has been amended deleted = actionId has been deleted
position
string
This conveys the position the fighters were in when this action occurred. Possible values include backControl, clinch, distance, guard, halfGuard, miscGround, mount, sideControl.
round
number
Which round this action occurred in
Fighter Object
Field Name
Type
Description
red
object
colour for fighter (new field, unsure about description)
blue
object
colour for fighter (new field, unsure about description)
Red Object
Field Name
Type
Description
name
string
name of fighter
fighterId
integer
ID of fighter
ufcFighterId
string
UFC fighter ID
pflFighterId
string
pfl fighter Id, will be null
Blue Object
Field Name
Type
Description
name
string
name of fighter
fighterId
integer
ID of fighter
ufcFighterId
string
UFC fighter ID
pflFighterId
string
pfl fighter Id, will be null
Details format:
Field Name
Type
Description
target
string
The body part at which the strike was aimed, such as head, body, leg etc. In the case of submissions or takedowns, this is usually provided as submission or takedown respectively.
strength
string
The strength behind the action; possible values are Sig, representing a significant blow, and Other, representing a less significant jab, a feint, or something else.
strikeType
string
Whether this action involved the arms or legs; possible values are arm and leg. This may mean a punch or a kick, but may also refer to an elbow/knee strike, a strangle, or something else depending on the action type.
eventElementType values:
Value
Meaning
position
Simply indicates the position the fighters are in; a round will open with this event. The details, resultsand fighter fields will not be provided.
strike
Indicates that the specified fighter attempted to strike their opponent. The details and results fields will indicate where the blow was aimed, whether it landed, how much force was behind it, and whether it was a punch / elbow strike or a kick / knee strike. See the details table.
takedown
Indicates that the specified fighter attempted to take down their opponent.
submission
Indicates that the specified fighter attempted to force a submission from their opponent.
knockdown
Indicates that the specified fighter attempted to knock down their opponent.
standup
Indicates that a fighter attempted to stand up.
reversal
Indicates that a fighter attempted to execute a reversal.
stop
Indicates that the round ended. The details, results and fighter fields will not be provided.
pause
Indicates that the round was paused. The details, results and fighter fields will not be provided.
Sample Response:
Here’s a sample of the output we have for fight 9553, Diego Lopes vs. Jean Silva; this packet represents a successful, significant strike to the head, where Diego Lopes is the attacker. It also indicates that the fighters were standing apart from one another when the blow was dealt.
Last updated
Was this helpful?