---
title: Next to Score (live)
description: Which side scores the next goal, live, for every football match in play — probabilities, the evidence behind them and the model's track record. Football API Unlimited.
badge: addon
---

# 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](/addons/).

## 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.

```json
{
  "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"
  }]
}
```

- `probabilities` are 0–1 and sum to 1. `no_goal` is `null` on the rare matches
  only the two-way model can price.
- `is_call` is true when the leader's probability clears `call_threshold`: these
  are the reads we publish. `call_paused` means 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.
