GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Probabilities API – Timeline Endpoint Now Includes Pre-Match Probabilities

We've expanded the Timeline endpoint of our Probabilities API to return a complete chronological probability history for a sport event. The feed now includes pre-match probability changes in addition to the in-game changes it already returned.

Previously, the Timeline endpoint returned only in-game probability movement. It now returns the full history — from the earliest pre-match probability through the final whistle — in a single call, including for completed matches.


⭐ Benefit

Retrieve the full probability movement for a sport event in a single call — ideal for post-match analysis, probability-movement visualizations, and editorial storytelling that compares pre-match expectations against how a game actually played out.


📋 Recommended Actions

  • Expect Timeline responses to be larger than before, with pre-match <market> entries preceding the first in-game entry. Timestamps on the pre-match entries can precede kickoff by weeks.
  • To scope to in-game movement only, filter the returned <market> entries by comparing each last_updated timestamp against the sport event's start_time.
  • Use the complete history for post-match analysis, probability-movement charts, and comparisons of pre-match expectations against the final result.

🔢 Products

ProductVersion(s)
Probabilities APIv1

🔁 Endpoints Affected


☑️ Sample Request:

curl --request GET \
     --url https://api.sportradar.com/probabilities/trial/v1/en/sport_events/sr:sport_event:61300505/timeline.xml \
     --header 'accept: application/xml' \
     --header 'x-api-key: YOUR_API_KEY'

⚙️ Return Samples

<sport_event id="sr:sport_event:61300505" start_time="2025-08-15T19:00:00+00:00" start_time_confirmed="true">
    <sport_event_context>
        <sport id="sr:sport:1" name="Soccer"/>
        <category id="sr:category:1" name="England" country_code="ENG"/>
        <competition id="sr:competition:17" name="Premier League" gender="men"/>
        <season id="sr:season:130281" name="Premier League 25/26" start_date="2025-08-15" end_date="2026-05-24" year="25/26" competition_id="sr:competition:17"/>
        <stage order="1" type="league" phase="regular season" start_date="2025-08-15" end_date="2026-05-24" year="25/26"/>
        <round number="1"/>
        <groups>
            <group id="sr:league:95139" name="Premier League 25/26"/>
        </groups>
    </sport_event_context>
    <competitors>
        <competitor id="sr:competitor:44" name="Liverpool FC" country="England" country_code="ENG" abbreviation="LFC" qualifier="home"/>
        <competitor id="sr:competitor:60" name="AFC Bournemouth" country="England" country_code="ENG" abbreviation="BOU" qualifier="away"/>
    </competitors>
    <venue id="sr:venue:579" name="Anfield" capacity="61276" city_name="Liverpool" city_id="sr:city:31" country_name="England" map_coordinates="53.430622, -2.960919" country_code="ENG" timezone="Europe/London"/>
</sport_event>
<sport_event_status status="ended" match_status="ended" away_score="2" home_score="4" live="true"/>
<timeline>
    <market name="3way" last_updated="2025-06-18T08:30:22+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="69.4"/>
            <outcome name="draw" probability="17.5"/>
            <outcome name="away_team_winner" probability="13.1"/>
        </outcomes>
    </market>
    <market name="3way" last_updated="2025-06-18T08:35:16+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="73.9"/>
            <outcome name="draw" probability="16.4"/>
            <outcome name="away_team_winner" probability="9.7"/>
        </outcomes>
    </market>
    ... (additional pre-match probability snapshots) ...
    <market name="3way" last_updated="2025-08-15T19:00:00+00:00">
        <outcomes>
            <outcome name="home_team_winner" probability="69.8"/>
            <outcome name="draw" probability="17.2"/>
            <outcome name="away_team_winner" probability="13"/>
        </outcomes>
    </market>
    ... (in-game probability changes continue through final whistle) ...
</timeline>