circle-info
"Additional Solutions” provide insights into our range of media offerings; originally part of IMG & now part of Sportradar
chevron-right
search
sportradar.comSportradar Support Portal

Fight Stats

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

hashtag
Endpoint URL

wss://dde-streams.data.imgarena.com/mma/fights/{id}/livestats

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.

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

hashtag
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

fighters

object

information on the fighters

hashtag
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

The UFC fighter ID of the fighter to which these stats refer

pflFighterId

string

PFL fighter Id, will be null

hashtag
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

The UFC fighter ID of the fighter to which these stats refer

pflFighterId

string

PFL fighter Id, will be null

hashtag
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

hashtag
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

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

hashtag
Sample Response:

Here’s a sample of the output we have for fight 9325, Carlos Prates vs. Ian Machado Garry; 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.

PreviousFight DetailsNextFight Details Scenarios

Last updated

Was this helpful?