Live Table Tennis Scores API for Point-by-Point Match Data

{
  "event_id": "event_tt_90018",
  "match_id": "match_tt_48291",
  "type": "point_won",
  "sequence": 73,
  "set_number": 4,
  "player_id": "player_tt_101",
  "score": {
    "player_a": 8,
    "player_b": 6
  },
  "created_at": "2026-08-07T05:20:12Z"
}

{
  "set_history": [
    {
      "set": 1,
      "player_a": 11,
      "player_b": 7
    },
    {
      "set": 2,
      "player_a": 9,
      "player_b": 11
    },
    {
      "set": 3,
      "player_a": 11,
      "player_b": 6
    }
  ],
  "current_set": {
    "number": 4,
    "player_a": 8,
    "player_b": 6
  }
}

{
  "match_id": "match_tt_48291",
  "status": "retired",
  "winner_id": "player_tt_101",
  "retired_player_id": "player_tt_204",
  "sets": {
    "player_a": 2,
    "player_b": 1
  },
  "current_set": {
    "number": 4,
    "player_a": 8,
    "player_b": 6
  }
}

GET /v1/table-tennis/matches/live

GET /v1/table-tennis/matches/live
    ?tournament_id=tournament_211

{
  "data": {
    "match_id": "match_tt_48291",
    "status": "live",
    "round": "quarterfinal",
    "best_of": 7,
    "tournament": {
      "id": "tournament_211",
      "name": "Example International Open"
    },
    "player_a": {
      "id": "player_tt_101",
      "name": "Player A",
      "ranking": 8
    },
    "player_b": {
      "id": "player_tt_204",
      "name": "Player B",
      "ranking": 14
    },
    "sets": {
      "player_a": 2,
      "player_b": 1
    },
    "set_history": [
      {
        "set": 1,
        "player_a": 11,
        "player_b": 7
      },
      {
        "set": 2,
        "player_a": 9,
        "player_b": 11
      },
      {
        "set": 3,
        "player_a": 11,
        "player_b": 6
      }
    ],
    "current_set": {
      "number": 4,
      "player_a": 8,
      "player_b": 6
    },
    "server_player_id": "player_tt_204",
    "last_event": {
      "event_id": "event_tt_90018",
      "type": "point_won",
      "player_id": "player_tt_101"
    },
    "updated_at": "2026-08-07T05:20:12Z"
  }
}

const response = await fetch(
  '/api/table-tennis/matches/live'
);

if (!response.ok) {
  throw new Error(
    `Live scores request failed: ${response.status}`
  );
}

const payload = await response.json();

for (const match of payload.data) {
  renderLiveMatch(match);
}

function renderLiveMatch(match) {
  const currentSet = match.current_set;

  console.log(
    `${match.player_a.name} ${match.sets.player_a}` +
    ` - ${match.sets.player_b} ${match.player_b.name}`
  );

  if (currentSet) {
    console.log(
      `Set ${currentSet.number}: ` +
      `${currentSet.player_a}-${currentSet.player_b}`
    );
  }
}

import requests

response = requests.get(
    "https://api.example.com/v1/table-tennis/matches/live",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    timeout=15,
)

response.raise_for_status()
payload = response.json()

for match in payload["data"]:
    print(
        match["player_a"]["name"],
        match["sets"]["player_a"],
        "-",
        match["sets"]["player_b"],
        match["player_b"]["name"],
    )

<?php

$url = 'https://api.example.com/v1/table-tennis/matches/live';

$ch = curl_init($url);

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json',
    ],
    CURLOPT_TIMEOUT => 15,
]);

$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($body === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);

if ($status < 200 || $status >= 300) {
    throw new RuntimeException(
        'Live scores API returned HTTP ' . $status
    );
}

$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);

let refreshTimer;

function startLiveScorePolling() {
  stopLiveScorePolling();

  refreshTimer = setInterval(async () => {
    if (document.visibilityState !== 'visible') {
      return;
    }

    try {
      await loadLiveScores();
    } catch (error) {
      console.error(error);
    }
  }, 15000);
}

function stopLiveScorePolling() {
  if (refreshTimer) {
    clearInterval(refreshTimer);
    refreshTimer = undefined;
  }
}

{
  "action": "subscribe",
  "channel": "table_tennis_match_events",
  "match_ids": [
    "match_tt_48291"
  ]
}

Before the match:
REST loads fixture and player context

At match start:
REST loads complete current state

During play:
WebSocket delivers supported point and set events

After disconnect:
REST reloads authoritative state
WebSocket reconnects and resubscribes

At match end:
REST confirms the final result

processed_table_tennis_events

event_id          unique
match_id
sequence
event_type
set_number
player_id
processed_at

1. Detect stale or closed connection
2. Mark the interface as reconnecting
3. Wait using controlled backoff
4. Request the latest match state through REST
5. Reopen the WebSocket connection
6. Authenticate
7. Resubscribe to the required match
8. Compare the last processed sequence
9. Apply only missing events
10. Restore the live indicator

provider_event_time
backend_received_time
processing_completed_time
frontend_displayed_time

End-to-end freshness =
frontend_displayed_time - provider_event_time

Live Demo

Tournament
Example International Open

Quarterfinal
Player A                 Player B
Sets: 2                  Sets: 1

Current set: 4
Points: 8                Points: 6

Status: LIVE
Last update: API_TIMESTAMP