This section summarises the players, ball and referee tracking websockets that are available via the DDE.
Within this section you will find schema information and samples with supporting documentation, as well as information about access protocol. Below are the available websockets with more information on each within the supporting documentation:
Low latency tracking feed
Describes all the player, ball and referee movement which occours during play (Time, Position, etc)
wss://dde-generic-datastream.dde-prod.imgarena.dev/ws/soccer/tracking/low_latency
Note currently supporting MLS matches only.
This API provides a stream of live players, ball and referee tracking data as JSON over a WebSocket connection. Please see the below for how to connect.
This section details and describes the payload which contains the home and away players, the ball and referee positions.
Field Name
Type
Description
id
string
DDE fixture ID.
ix
integer
Index per channel and sub-type (event type in event channel).
ph
integer
Number of the current phase.
st
string
State of the current phase: [start] - first message of the phase. [running] phase is in progress . [end] final message of the phase.
ut
integer
UTC time - utc time, in milliseconds since Jan 01 1970. (UTC).
ba
object
Ball - statistics on ball.
hm
object
Home Team - statistics on home team's players.
aw
object
Away Team - statistics on away team's players.
rf
object
statistics on referees.
Field Name
Type
Description
tm
string
Team - team in possession of the ball.
jn
integer
Jersey Number - jersey number of the player in possession of the ball, -1 for unknowns.
ph
array
Phase - number of the current phase.
Field Name
Type
Description
ro
integer
Role - Index identifying player's role: 1 for goalkeepers. 2 for players. 3 for referees. -1 for unknowns
jn
integer
Jersey Number - jersey number for the player. Note -1 for unknowns.
pl
string
Player Id - Player id for the player. Note null for unknowns.
v
float
Speed - current speed of the player [meters/second]
pn
array
Position - (x, y) player coordinates, origin is pitch center [meters]
Field Name
Type
Description
ro
integer
Role - Index identifying player's role: 1 for goalkeepers. 2 for players. 3 for referees. -1 for unknowns
jn
integer
Jersey Number - jersey number for the player. Note -1 for unknowns.
pl
string
Player Id - Player id for the player. Notenull for unknowns.
v
float
Speed - current speed of the player [meters/second]
pn
array
Position - (x, y) player coordinates, origin is pitch center [meters]
Field Name
Type
Description
ro
integer
Role - Index identifying player's role: 1 for goalkeepers.
2 for players.
3 for referees.
-1 for unknowns
jn
integer
Jersey Number - jersey number for the player. Note -1 for unknowns.
v
float
Speed - current speed of the player [meters/second].
pn
array
Position - (x, y) player coordinates, origin is pitch center [meters].