List today's games

Games with player props posted for the given sport, merged across free books. Live games first. This is a schedule/event-discovery feed in its own right: use it to learn what is on the board before asking for props. An empty list is classified (emptyReason) so an off day, a season break and a source outage are told apart, and pollAdvice says what a poller should do next. data.refreshCadenceSeconds is how often the board behind it actually rebuilds; polling faster than that cannot return anything new. When the board identity is pinned the response carries a strong ETag: send it back as If-None-Match and an unchanged board answers 304 with no body. A 304 still authenticates and still counts against your rate limit; what it saves is the transfer.

Poll it like this: keep the ETag, treat 304 as "same board", and wait as long as pollAdvice says. stop_until_coverage_returns (offseason) and wait_for_refresh on no_games_scheduled are expected schedules, not errors; backoff_source means the upstream source is down or stale.

let etag = null;
async function poll() {
  const res = await fetch('https://api.flashodds.live/api/v1/games?sport=cs2', {
    headers: { Authorization: `Bearer ${KEY}`, ...(etag ? { 'If-None-Match': etag } : {}) }
  });
  let wait = 300;
  if (res.status !== 304) {
    etag = res.headers.get('ETag') ?? etag;
    const body = await res.json();
    wait = body.pollAdvice.suggestedSeconds ?? body.data.refreshCadenceSeconds;
    if (body.empty) console.log(body.emptyReason, body.pollAdvice.action);
    else render(body.games);
  }
  setTimeout(poll, wait * 1000);
}