Next to Score#
Live, for every football match in play: the probability that the home side, the away side or nobody scores the next goal. The read updates every minute from in-play evidence (momentum, recent shots, red cards, score and clock), anchored on the pre-match market where one exists.
It is the one model we publish that beats the live market on outcomes, and
every call it makes is recorded and graded, so you can check that yourself with
/calls/ below.
Requires Football API Unlimited. Other tokens get 403 with
"code": "unlimited_required". Upgrade on Add-ons.
Every live match#
GET /api/v2/next-goal/
| Param | Type | Description |
|---|---|---|
league_id |
int | One competition |
calls_only |
bool | Only matches where the read is strong enough to be a published call |
limit / offset |
int | Pagination (default 100, max 200) |
A match appears once the model can read it, usually from around minute 10.
{
"count": 1, "next": null, "previous": null,
"results": [{
"event": {"id": 212690, "status": "2nd_half", "home_team": "Czechia", "away_team": "Spain",
"home_team_id": 101, "away_team_id": 102, "league_id": 30, "league_name": "...",
"event_date": "2026-11-22T19:45:00Z"},
"minute": 55,
"score": {"home": 0, "away": 1},
"probabilities": {"home": 0.24, "away": 0.62, "no_goal": 0.14},
"leader": "away",
"confidence": 0.62,
"is_call": true,
"call_threshold": 0.6,
"call_paused": false,
"minutes_since_goal": 18,
"evidence": {"momentum_5m": -14.2, "momentum_15m": -9.8, "shots_home_10m": 0,
"shots_away_10m": 3, "red_cards_home": 0, "red_cards_away": 0},
"track_record": {"accuracy": 0.72, "base_rate": 0.51, "brier_skill_score": 0.21,
"matches_evaluated": 3300},
"generated_at": "2026-11-22T20:41:05Z"
}]
}
probabilitiesare 0–1 and sum to 1.no_goalisnullon the rare matches only the two-way model can price.is_callis true when the leader's probability clearscall_threshold: these are the reads we publish.call_pausedmeans it would be a call, but a goal went in within the last few minutes and the read is held until the match settles.momentum_*is positive when the home side is on top.
One match#
GET /api/v2/next-goal/{event_id}/
Same object plus "available": true. When there is no read you get
{"event": {...}, "available": false, "reason": "not_live" | "too_early"}.
Published calls and results#
GET /api/v2/next-goal/calls/
| Param | Type | Description |
|---|---|---|
event_id |
int | One match |
outcome |
string | hit · miss · nogoal · unclear · open |
date_from |
date | YYYY-MM-DD |
limit / offset |
int | Pagination (default 50, max 200) |
Each call: minute, side (home/away), team, probability,
score_at_call, outcome and when it resolved. hit means the called side
scored next; nogoal means the match ended without another goal.
Freshness#
Reads move once a minute and are cached for 15 seconds. Polling every 30–60
seconds per match is plenty; GET /api/v2/next-goal/ gives every live match in
one call.