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.

// 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);
}

​

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