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 eachlast_updatedtimestamp against the sport event'sstart_time. - Use the complete history for post-match analysis, probability-movement charts, and comparisons of pre-match expectations against the final result.
🔢 Products
| Product | Version(s) |
|---|---|
| Probabilities API | v1 |
🔁 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>