The Live Actions websocket contains a live 'stream' of the team and player actions happening within the football match - this will include; goals, cards, shots and more.
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.
N.B – This endpoint sends heartbeats in-between data packets to let you know that it is still connected.
wss://dde-streams.data.imgarena.com/media/soccer/fixtures/{fixtureId}/actions
N.B. – Please insert the relevant fixtureId returned from the fixtures API endpoint to return you the data. The authentication token provided will be required to make a connection to this websocket endpoint.
Connect to 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 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.
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.
There are 2 optional params, that are in common with these Websocket endpoints:
“speed” - this can be “fast” or “normal”. 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 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
The below information details the key fastpath actions and sub action types we will be collecting live and distributing via the live Actions websocket. An action type can be something like a goal, card, dangerous attack. The sub action type gives extra context to that initial action type. i.e. a goal (action type) scored from inside the box (sub action type).
https://docs.imgarena.com/soccer/action-types
This section details and describes the values within the actions payload (replaces the swagger actions websocket doc)
https://docs.imgarena.com/soccer/json-objects/live-objects
This endpoint is a live match websocket endpoint that returns the full set up of player & team statistics.
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.
N.B – This endpoint sends heartbeats in-between data packets to let you know that it is still connected.
This endpoint currently takes no request parameters
wss://dde-streams.data.imgarena.com/media/soccer/fixtures/{fixtureId}/statistics
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.
There are 2 optional params, that are in common with these Websocket endpoints:
“speed” - this can be “fast” or “normal”. 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 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
https://docs.imgarena.com/soccer/statistics