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/media/mma/fight-actions/feed/{id}

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

This endpoint currently takes no request parameters.

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.
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

Blue Object

Field Name	Type	Description
name	string	name of fighter
fighterId	integer	ID of fighter

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 9088, Jhonata Diniz vs. Marcin Tybura; this packet represents a successful, significant strike to the body, where Marcin Tybura is the attacker. It also indicates that the fighters were standing apart from one another when the blow was dealt.

{
  "details": {
    "strength": "Sig",
    "target": "body"
  },
  "eventElementType": "strike",
  "fighter": "Red",
  "fighters": {
    "blue": {
      "fighterID": 4039,
      "name": "Jhonata Diniz"
    },
    "red": {
      "fighterID": 2753,
      "name": "Marcin Tybura"
    }
  },
  "id": 895561,
  "position": "distance",
  "result": "successful",
  "round": 1,
  "roundTime": "04:51",
  "seqNum": 1,
  "timestamp": "2024-11-17T01:12:26Z"
}