performance

Aggregate model performance for a sport

Returns headline metrics for the requested sport's match model. The source parameter is mutually exclusive — never a union, so a dashboard can never double-count the same match across two regimes:

• production — predictions that existed in our database BEFORE kick-off, graded afterwards. The default, and the only source for nba, euroleague, football, tennis and wta. • backtest — a chronological out-of-sample holdout of the deployed model, graded after the fact. Published for champions only, because that module has no as-published record yet. It is a weaker claim than production and is labelled as such in the response's own source field. • test (Phase 3.1) — the held-out test set of the currently deployed model. Not yet exposed.

Read the response's source field, never the request. A sport that has no record under the requested source answers 404 with an explanation; it never substitutes another regime's numbers.

get/v1/performance/{sport}

Request

  • Base URL: https://api.predixsport.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.predixsport.com/v1/performance/{sport}
  • Auth: none declared

Path parameters

sport'nba' | 'euroleague' | 'football' | 'tennis' | 'wta' | 'champions' required

Query parameters

source'production' | 'test' | 'backtest'

Mutually exclusive performance source. Defaults to production for every sport — champions has no production record yet and answers 404 there, pointing at ?source=backtest. The default is deliberately NOT switched per sport: a default that silently changes regime is how a backtest ends up labelled production.

league'serie_a' | 'premier_league' | 'la_liga' | 'bundesliga' | 'ligue_1' | 'championship' | 'league_one' | 'league_two' | 'segunda_division' | 'ligue_2' | 'bundesliga_2' | 'serie_b'

Football only — narrow to one league. Omit for cross-league aggregate.

Headers

authorizationstring nullable

Response

Successful Response

OR
OR
OR
OR
OR

Changes

No recorded changes to this operation across all 1 revision of this API.