> For the complete documentation index, see [llms.txt](https://docs.sportmonks.com/v3/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/predictions/live-predictions-beta.md). # Live Predictions (beta) **📦 Add-on Required** > Live Predictions requires the **Predictions add-on** > > Available with all base plans. [View pricing →](https://www.sportmonks.com/football-api/plans-pricing/) Live predictions give you a per-minute probability snapshot of the fulltime result for any live match. A new record is written each match minute, so you can track how the predicted outcome shifts in real time as the game unfolds. {% hint style="info" %} Please note that this feature is currently still in beta {% endhint %} ### How it works The model is powered by Octosport and requires sufficient historical statistics coverage to run. Availability is determined per fixture - not per league. A fixture typically becomes live-predictable within the first 10 minutes of kick-off. When it does, the model back-fills predictions for all previous minutes in that period. Per match minute, one `LivePrediction` record is exposed, containing the home, away and draw probabilities. ### Checking availability Before requesting live predictions for a fixture, check whether it is live-predictable using the `LIVE_PREDICTION_STATUS` metadata type: ```http https://api.sportmonks.com/v3/football/fixtures/{fixture_id} ?include=metadata.type&api_token=YOUR_TOKEN ``` ```json "metadata": [ { "id": 9561219, "metadatable_id": 19656849, "type_id": 117442, "value_type": "object", "values": { "live_predictable": true }, "type": { "id": 117442, "name": "Live Prediction Status", "code": "live-prediction-status", "developer_name": "LIVE_PREDICTION_STATUS", "model_type": "metadata", "stat_group": "" } } ] ``` `live_predictable: true` means live predictions are or will become available for this fixture. `live_predictable: false` means the model cannot generate predictions for this fixture and no records will be written. This follows the same pattern as `PREDICTION_STATUS` for regular predictions and `PRESSURE_STATUS` for the Pressure Index. ### Retrieving live predictions #### All live fixtures ```http https://api.sportmonks.com/v3/football/predictions/live/probabilities ?api_token=YOUR_TOKEN ``` #### Single fixture ```http https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/{fixture_id} ?api_token=YOUR_TOKEN ``` #### As a fixture include Live predictions are also accessible as a nested include directly on a fixture: ```http https://api.sportmonks.com/v3/football/fixtures/{fixture_id} ?include=livePredictions&api_token=YOUR_TOKEN ``` ### Using includes Three includes are available on `LivePrediction` records: `fixture`, `period`, and `type`. ```http https://api.sportmonks.com/v3/football/predictions/live/probabilities/fixtures/19656849 ?include=fixture;period;type&api_token=YOUR_TOKEN ``` ```json { "data": [ { "id": 181, "fixture_id": 19656849, "period_id": 6965194, "minute": 1, "predictions": { "home": 52.08, "away": 25.76, "draw": 22.15 }, "type_id": 237, "period": { "id": 6965194, "fixture_id": 19656849, "type_id": 1, "started": 1779096745, "ended": 1779099528, "counts_from": 0, "ticking": false, "sort_order": 1, "description": "1st-half", "time_added": 2, "period_length": 45, "minutes": 46, "seconds": 23, "has_timer": false }, "fixture": { "id": 19656849, "sport_id": 1, "league_id": 1490, "season_id": 27065, "name": "South Melbourne vs Caroline Springs George Cross FC", "starting_at": "2026-05-18 09:30:00" }, "type": { "id": 237, "name": "Fulltime Result Probability", "code": "fulltime-result-probability", "developer_name": "FULLTIME_RESULT_PROBABILITY", "model_type": "prediction", "stat_group": null } } ] } ``` ### Coverage Live prediction coverage follows the same leagues as the regular Predictions add-on. For a full breakdown of which leagues and competitions are covered, see the [Data Features per League](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/data-features-per-league) reference. {% hint style="info" %} Please check the `LIVE_PREDICTION_STATUS` metadata to exactly spot the availability per fixture. {% endhint %} ### See also **Live Predictions endpoints** * [GET Live Probabilities](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/predictions/get-live-probabilities) * [GET Live Probabilities by Fixture ID](https://docs.sportmonks.com/v3/endpoints-and-entities/endpoints/predictions/get-live-probabilities-by-fixture-id) **Regular predictions** * [Probabilities](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/predictions/probabilities) * [Value Bet](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/predictions/value-bet) **Reference** * [LivePrediction entity](https://docs.sportmonks.com/v3/endpoints-and-entities/entities/odd-and-prediction#liveprediction) * [Data Features per League](https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/data-features-per-league) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.sportmonks.com/v3/tutorials-and-guides/tutorials/odds-and-predictions/predictions/live-predictions-beta.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.