Media - Live statistics

Provide aggregated data of matches such as statistics, scores, line-ups used for analysis and visualisation.

The statistics websocket contains a live 'stream' of the team and player actions happening within a match. This websocket is typically for clients wanting to integrate aggregated stats data to power live media and broadcast customers websites, apps etc. The only difference currently to the betting version of the websockets, is the latency with which data to the websockets are delivered

You should receive a new update any time a key action is completed and this websocket is crucial for powering live scores and match actions. The authentication token provided will be required to make a connection to this websocket endpoint. Once you have the API token, any further data that you send over the connection will be ignored. This endpoint sends heartbeats in-between data packets to let you know that it is still connected.

Endpoint URL

Aggregated live statistics

CONNECT wss://dde-streams.data.imgarena.com/media/{sport}/fixtures/{fixtureId}/statistics

Path Parameters

Name
Type
Description

sport*

String

soccer

fixtureId*

UUID

Unique id of a requested fixture.

Query Parameters

Name
Type
Description

speed

String

this can be “fast” or “normal”. Default is normal and only applicable for offline matches

startPosition

Integer

default is 0. This is how many events to skip from the beginning of the list of events. e.g. 5 would be start sending events from the 5th event received for that websocket. This is a useful feature if you want to continue without getting all the events again from the beginning when you reconnect

Headers

Name
Type
Description

Accept*

String

application/vnd.imggaming.dde.api+json;version=1

Connection

String

keep-alive

{
    The supplied authentication is invalid
}

Authentication

We don't look at the header for websockets. Instead we expect the client to push through that auth message immediately on connecting in the following format.

{"authToken": "ACCESS_TOKEN"}

Request limits

IMG Arena monitors customer traffic to ensure it follows guidelines and isn't excessive. We recommend a request rate of 5 per second and encourage staying connected to websockets instead of repeated re-connections.

Response Fields

seqNum integer

The sequence number

traceId uuid

Tracing Id for logs

version integer

The version number

finished boolean

Whether the match has finished or not Values are true or false

fixtureId uuid

The unique id of the match

timestamp timestamp

The timestamp of the file and it's usually the time the latest action update has happened

Aggregated player action statistics

Aggregated team sports statistics

PreviousMedia - Live actionsNextMLS - P&B Tracking (Websockets)

Last updated