Pre-Match

Overview

This section will describe the packets that are received upon the start of the match. At the start of every tennis match, the same packets should be received in the same order.

MATCH STATUS UPDATE - Not Started

If you connect to any match that has not started, you will receive the following packet. This packet is always a response to any match that has not started and it will always be the packet with sequence number 0 when connecting to any websocket event.

The packet is as follows:

• MATCH STATUS UPDATE - Not Started JSON

{
  "timestamp": "1970-01-01T00:00:00.000Z",
  "eventElementType": "MatchStatusUpdate",
  "matchTime": "00:00:00",
  "seqNum": 0,
  "matchStatus": {
    "umpireCountry": "Unknown",
    "umpire": "Unknown",
    "teamAPlayer1": "Unknown",
    "tossChooser": "Unknown",
    "matchState": {
      "state": "NotStarted"
    },
    "teamBPlayer1": "Unknown",
    "numSets": -1,
    "scoringType": "UnknownScoringType",
    "firstServer": "UnknownTeam",
    "tossWinner": "UnknownTeam",
    "courtNum": -1,
    "teamAPlayersDetails": {
      "player1Id": "Unknown",
      "player1Country": "Unknown"
    },
    "teamBPlayersDetails": {
      "player1Id": "Unknown",
      "player1Country": "Unknown"
    },
    "umpireCode": "Unknown",
    "tieBreakType": "Unknown"
  }
}

MATCH STATUS UPDATE - Umpire On Court

The first packet with information on each match, with "seqNum" : 1 will always be the Umpire On Court Packet.

This will include information on the Umpire and the players, the scoring type and set length of the match. Receiving this packet means that the match is going to start shortly.

The packet is as follows:

• MATCH STATUS UPDATE - Umpire On Court JSON

{
  "eventElementType": "MatchStatusUpdate",
  "matchStatus": {
    "courtNum": 2,
    "firstServer": "UnknownTeam",
    "matchState": {
      "locationTimestamp": "2024-05-20T11:33:19",
      "state": "UmpireOnCourt"
    },
    "numSets": 3,
    "scoringType": "Standard",
    "teamAPlayer1": "D. THIEM",
    "teamAPlayersDetails": {
      "player1Country": "AUT",
      "player1Id": "TB69"
    },
    "teamBPlayer1": "F. AGAMENONE",
    "teamBPlayersDetails": {
      "player1Country": "ITA",
      "player1Id": "AA27"
    },
    "tieBreakType": "TieBreakInFinalSet",
    "tossChooser": "UnknownTossChooser",
    "tossWinner": "UnknownTeam",
    "umpire": "Unknown",
    "umpireCode": "Unknown",
    "umpireCountry": "Unknown"
  },
  "matchTime": "00:00:00",
  "seqNum": 1,
  "timestamp": "2024-05-20T09:33:19.978Z"
}

MATCH STATUS UPDATE - Players Arrive On Court

The second packet that is received is the 'Players Arrive on Court' packet. This indicates that both players are on the court and are preparing for the match.

The packet is as follows:

• MATCH STATUS UPDATE - Players Arrive On Court JSON

{
  "eventElementType": "MatchStatusUpdate",
  "matchStatus": {
    "courtNum": 2,
    "firstServer": "UnknownTeam",
    "matchState": {
      "locationTimestamp": "2024-05-20T11:40:32",
      "state": "PlayersArriveOnCourt"
    },
    "numSets": 3,
    "scoringType": "Standard",
    "teamAPlayer1": "D. THIEM",
    "teamAPlayersDetails": {
      "player1Country": "AUT",
      "player1Id": "TB69"
    },
    "teamBPlayer1": "F. AGAMENONE",
    "teamBPlayersDetails": {
      "player1Country": "ITA",
      "player1Id": "AA27"
    },
    "tieBreakType": "TieBreakInFinalSet",
    "tossChooser": "UnknownTossChooser",
    "tossWinner": "UnknownTeam",
    "umpire": "Unknown",
    "umpireCode": "Unknown",
    "umpireCountry": "Unknown"
  },
  "matchTime": "00:00:00",
  "seqNum": 2,
  "timestamp": "2024-05-20T09:40:33.337Z"
}

MATCH STATUS UPDATE - Warmup (Inc. Coin Toss Info)

The next packet will indicate that the state of the match is in 'Warmup' and that the players are warming up.

This packet will also contain information on which player won the coin toss, and whether they chose to serve, receive or chose a particular side.

The packet is as follows:

• MATCH STATUS UPDATE - Warmup JSON

{
  "eventElementType": "MatchStatusUpdate",
  "matchStatus": {
    "courtNum": 2,
    "firstServer": "TeamB",
    "matchState": {
      "locationTimestamp": "2024-05-20T11:42:10",
      "state": "Warmup"
    },
    "numSets": 3,
    "scoringType": "Standard",
    "teamAPlayer1": "D. THIEM",
    "teamAPlayersDetails": {
      "player1Country": "AUT",
      "player1Id": "TB69"
    },
    "teamBPlayer1": "F. AGAMENONE",
    "teamBPlayersDetails": {
      "player1Country": "ITA",
      "player1Id": "AA27"
    },
    "tieBreakType": "TieBreakInFinalSet",
    "tossChooser": "Serve",
    "tossWinner": "TeamA",
    "umpire": "Unknown",
    "umpireCode": "Unknown",
    "umpireCountry": "Unknown"
  },
  "matchTime": "00:00:00",
  "seqNum": 5,
  "timestamp": "2024-05-20T09:46:51.693Z"
}

MATCH STATUS UPDATE - In Progress

The next packet, 'In Progress', will indicate that the match has started.

The packet is as follows:

• MATCH STATUS UPDATE - In Progress JSON

{
  "eventElementType": "MatchStatusUpdate",
  "matchStatus": {
    "courtNum": 2,
    "firstServer": "TeamB",
    "matchState": {
      "locationTimestamp": "2024-05-20T11:48:03",
      "state": "InProgress"
    },
    "numSets": 3,
    "scoringType": "Standard",
    "teamAPlayer1": "D. THIEM",
    "teamAPlayersDetails": {
      "player1Country": "AUT",
      "player1Id": "TB69"
    },
    "teamBPlayer1": "F. AGAMENONE",
    "teamBPlayersDetails": {
      "player1Country": "ITA",
      "player1Id": "AA27"
    },
    "tieBreakType": "TieBreakInFinalSet",
    "tossChooser": "Serve",
    "tossWinner": "TeamA",
    "umpire": "Unknown",
    "umpireCode": "Unknown",
    "umpireCountry": "Unknown"
  },
  "matchTime": "00:00:00",
  "seqNum": 6,
  "timestamp": "2024-05-20T09:48:03.934Z"
}

Point Started

Following the above, when the first point in the match is under way, the umpire will issue a 'Point Started' packet.

This packet is issued at the start of every point in any match.

Best Practice

Use 'Point Started' packets to automatically close markets and to suspend betting.

• Point Started JSON

{
  "eventElementType": "PointStarted",
  "matchTime": "00:00:00",
  "nextServer": {
    "member": 1,
    "team": "TeamB"
  },
  "seqNum": 7,
  "server": {
    "member": 1,
    "team": "TeamB"
  },
  "timestamp": "2024-05-20T09:48:04.047Z"
}