Connecting Programmatically

Overview

To connect to the system programmatically, you will need to provide the IP address (or addresses/blocks) that you will connect from.

You will then be provided with one API token that will allow you to gain secured access to both the list of events (Schedule) and the live data (Streams) that you have licensed from IMG Gaming.

For non-streaming schedule data, all API requests should be directed to the following URL:

Legacy URL: https://dde-api.imggaming.com/

New URL: https://dde-api.data.imgarena.com/

Requests for streamed live data should be issued to:

Legacy URL: wss://dde-streams.imggaming.com/

New URL: wss://dde-streams.data.imgarena.com/

Schedule API

Our Schedule API provides the following end points. These end points are all related to Draw or Order of Play (OOP) information:

/players

/tournaments

/tournaments/{id}

/tournaments/{id}/draws

/tournaments/{id}/events

/competitions/{id}/events

/competitions/{id}/draws

/tournaments/{id}/results

/tournaments/liveevents

Streams API

When a new event appears on the /tournaments/liveevents endpoint, you should automatically connect to the SSL websocket address for that event:

1) Call https://dde-api.data.imgarena.com/tournaments/liveevents (this should be requested every 10 seconds, so you do not miss a new event starting).

2) See a new event appear on the /tournaments/liveevents endpoint, e.g.

{
        "startTime": {
            "status": "FollowsPrevious"
        },
        "teamA": {
            "status": "KnownTennisTeam",
            "team": {
                "player1": {
                    "id": "MN13",
                    "firstName": "Maximilian",
                    "lastName": "Marterer",
                    "country": "GER"
                },
                "entryType": "Standard",
                "seed": 8
            }
        },
        "eventId": "2022-6809-MS028",
        "teamB": {
            "status": "KnownTennisTeam",
            "team": {
                "player1": {
                    "id": "F0BT",
                    "firstName": "Jonas",
                    "lastName": "Forejtek",
                    "country": "CZE"
                },
                "entryType": "Standard"
            }
        },
        "tournamentName": "Rhein Asset Open"
    },

3) Connect to the new match on the live streams endpoint:

There are two stream endpoints that you can connect to for a live event:

Legacy URL: Live Streams, e.g: wss://dde-streams.imggaming.com/events/2022-6809-MS028/stream

Legacy URL: Live Statistics, e.g: wss://dde-streams.imggaming.com/events/2022-6809-MS028/statistics

New URL: Live Streams, e.g: wss://dde-streams.data.imgarena.com/events/2022-6809-MS028/stream

New URL: Live Statistics, e.g: wss://dde-streams.data.imggarena.com/events/2022-6809-MS028/statistics