Sports Live Source Health

Customer-facing source-freshness diagnostic.

Returns per-source freshness for the requested sport: which feeds are emitting events, when they last did, and how many events landed in the last 5 minutes. Use this to detect when a source goes stale so your bot doesn't trade on dead data.

Response shape (one row per source actively emitting for this sport): [ { "sport_key": "basketball_nba", "source": "nba_live", "role": "primary", "events_last_5min": 142, "seconds_since_last_event": 3.2, "latest_capture_ms": 1778214028111 }, ... ]

Free tier OK. 1 credit per call. Recommended polling cadence: every 30 seconds. If a source you care about shows seconds_since_last_event

60 during a known-live game, that source has gone stale; failover to another source or the league-API path.

Empty-when-healthy semantics (iter_064 #479): the pbp_source_health table is populated by the source-health monitor only when a feed transitions into a degraded state (slow / silent / errored). A response of {count: 0, results: []} means every tracked source for the sport is firing within its expected cadence. Treat empty as a positive signal, not a missing-data signal. To verify the underlying source is actually live, cross-reference /live/api/data_flow which always returns the per-source pulse snapshot.