Betting - Live actions

This section provides details and descriptions of the values in the actions payload for betting customers.

The Live Actions websocket offers a live 'stream' of team and player actions during a match. It is primarily used by clients integrating data for live betting markets. Updates will be received whenever a key action is completed, and this websocket is essential for live scores and match actions. To connect to this websocket endpoint, the provided authentication token is required. Heartbeats are sent from this endpoint between data packets to indicate a continuous connection.

Endpoint URL

Live match actions

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

Path Parameters

Name	Type	Description
sport*	String	soccer
fixtureId*	UUID	Unique id of a requested fixture.

Headers

Name	Type	Description
Accept*	String	application/vnd.imggaming.dde.api+json;version=1
Connection	String	keep-alive

401: Unauthorized

{
    The supplied authentication is invalid
}

400: Bad Request

{
    Request is missing required HTTP header 'Accept'
}

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"}

Polling limits

IMG Arena monitor the incoming traffic from our customers and strive to ensure that traffic is controlled, in-keeping with our guidelines and not unnecessarily excessive. We would suggest a polling rate of 5 requests per second, whilst we strive towards implementing rate limiting. Also, we would advise staying connected to the websockets rather than polling.

Request parameters

Two optional parameters are in common with these WebSocket endpoints:

• speed - this can be “fast” or “normal”. The default is normal and only applicable for offline matches.

• startPosition : integer value, default is 0. This is how many events to skip from the beginning of the list. e.g. five would start sending events from the 5th event received for that WebSockte. This is a helpful feature if you want to continue without getting all the events again from the beginning when you reconnect.

Response Fields

action Action []	Detailed player action details within a match