Live Events, Match Clock & Logos

​

Live Events

curl "https://api.odds-api.io/v3/events/live?sport=football&apiKey=YOUR_KEY"

​

The Clock Object

{
  "id": 65068198,
  "home": "Manchester City",
  "away": "Liverpool FC",
  "status": "live",
  "scores": { "home": 1, "away": 0 },
  "clock": {
    "minute": 67,
    "playedSeconds": 4023,
    "period": 2,
    "running": true,
    "statusDetail": "2nd half",
    "injuryTime": 4
  }
}

• clock is omitted entirely when no clock data is available for an event. Treat it as optional.
• minute and playedSeconds are extrapolated server-side from the live feed, so they stay accurate even when the response is served from cache.
• The clock only advances while running is true. During half-time and other breaks it freezes at the last played second.
• For a per-second ticker in your UI, extrapolate client-side from playedSeconds at the moment you received the response, while running is true.
• On WebSocket, the clock rides on live score/status messages, but those fire only on real events. Seed the initial clock with one GET /events/live on connect, then let the WebSocket re-anchor it.

// Per-second client-side ticker
const receivedAt = Date.now();
function currentSeconds(clock) {
  if (!clock.running) return clock.playedSeconds;
  return clock.playedSeconds + Math.floor((Date.now() - receivedAt) / 1000);
}

​

Cricket Scores

{
  "id": 71173666,
  "home": "Antigua And Barbuda Falcons",
  "away": "Barbados Tridents",
  "status": "live",
  "scores": {
    "home": 155,
    "away": 125,
    "periods": {
      "inning1": {
        "home": 155,
        "away": 125,
        "wickets": { "home": 6, "away": 9 },
        "overs":   { "home": 20, "away": 20 }
      }
    }
  }
}

• wickets and overs are cricket only. They are omitted for every other sport, so existing period scores keep exactly their home/away shape.
• Both are omitted when the source does not publish them, so treat them as optional even on cricket.
• A side that has not yet batted reads 0, not a missing key.
• Coverage varies by competition. Major internationals and the larger franchise leagues carry full innings detail; smaller domestic competitions may return a match-level score with no periods at all.

​

statusDetail values

​

Rendering a football clock the conventional way

function displayMinute(clock) {
  const cap = clock.period === 1 ? 45 : 90;
  if (clock.period <= 2 && clock.minute > cap) {
    return `${cap}+${clock.minute - cap}`; // e.g. "45+3"
  }
  return `${clock.minute}`;
}

​

Participant Logos

curl "https://api.odds-api.io/v3/participants/38/logo?apiKey=YOUR_KEY" -o crest.png

• Responses include Cache-Control: public, max-age=86400, so browsers and CDNs cache them for a day. You can hotlink the URL in an <img> tag.
• Returns 404 when no logo exists for the participant. Misses are cached server-side, so repeated lookups for logo-less participants stay fast.
• Logos are served from our infrastructure; no third-party provider URLs are exposed to your users.

​

Next Steps

• Stream live scores and match status over WebSocket instead of polling, see the WebSocket guide
• Fetch odds for live events with Fetching Odds