Integration GuidesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Integration Guides

Probabilities API Overview

The Probabilities API delivers Sportradar's calculated outcome probabilities for sport events: who is likely to win, expressed as percentages that update before and during play. Where the Odds Comparison APIs answer "what prices are bookmakers offering", the Probabilities API answers "how likely is each outcome".

The API provides:

  • Pre-match probabilities for upcoming events (2-way or 3-way, matching the sport's outcome structure)
  • Live probabilities that recalculate through play for competitions with live coverage, with score and game-state context attached
  • A probability timeline per event: every probability change from first estimate to the final 100 percent
  • Seasonal probabilities across a whole season's events in one paginated feed
  • Seasonal outright probabilities: title, division, and playoff-reach likelihoods per competitor


Covered Sports

The Sports feed returns the covered sports; this is the live response:

{
  "generated_at": "2026-07-20T16:30:41+00:00",
  "sports": [
    {
      "id": "sr:sport:16",
      "name": "American Football"
    },
    {
      "id": "sr:sport:3",
      "name": "Baseball"
    },
    {
      "id": "sr:sport:2",
      "name": "Basketball"
    },
    {
      "id": "sr:sport:21",
      "name": "Cricket"
    },
    {
      "id": "sr:sport:6",
      "name": "Handball"
    },
    {
      "id": "sr:sport:4",
      "name": "Ice Hockey"
    },
    {
      "id": "sr:sport:1",
      "name": "Soccer"
    },
    {
      "id": "sr:sport:5",
      "name": "Tennis"
    }
  ]
}

Per-competition coverage within a sport, including whether live probabilities are calculated, comes from the Sport Competitions feed's live_coverage flag; see Probabilities API Basics.



How It Fits with Odds Comparison

The Probabilities API shares its identifier scheme with the Odds Comparison packages: the same sr:sport_event: ID resolves in both, and each competition record exposes the GUIDs (uuids) that link it to the League Specific APIs. A single discovery pass can therefore feed odds boards and probability displays together; see ID Handling.



How the Guides Are Organized

The map below shows the three tiers; each pill links to its guide.

Probabilities Integration Guide MapTwo tiers, top to bottom
1Foundational
Overview (you are here)API BasicsFundamentals
Event scope (per game, live) sits in Tracking Win Probabilities; season scope (tables, outlooks) sits in Seasonal and Outright Probabilities.


A 60-Second Look at the Data

A completed game's timeline tells the story in three points (trimmed from its 1,181 points): the home side opened at 57.1 percent, fell to 7.7 percent while trailing 0 to 3, and finished at 100 percent after a comeback win:

{
  "generated_at": "2026-07-20T16:37:08+00:00",
  "sport_event_status": {
    "status": "ended",
    "match_status": "ended",
    "away_score": 3,
    "balls": 0,
    "bases": "1,0,0",
    "home_score": 4,
    "live": true,
    "outs": 2,
    "strikes": 0
  },
  "timeline": [
    {
      "name": "2way",
      "outcomes": [
        {
          "name": "home_team_winner",
          "probability": 57.1
        },
        {
          "name": "away_team_winner",
          "probability": 42.9
        }
      ],
      "live": true,
      "last_updated": "2026-07-19T00:09:24+00:00",
      "home_score": 0,
      "away_score": 0
    },
    {
      "name": "2way",
      "outcomes": [
        {
          "name": "home_team_winner",
          "probability": 7.7
        },
        {
          "name": "away_team_winner",
          "probability": 92.3
        }
      ],
      "live": true,
      "last_updated": "2026-07-19T01:58:46+00:00",
      "home_score": 0,
      "away_score": 3
    },
    {
      "name": "2way",
      "outcomes": [
        {
          "name": "home_team_winner",
          "probability": 100
        },
        {
          "name": "away_team_winner",
          "probability": 0
        }
      ],
      "live": true,
      "last_updated": "2026-07-19T03:26:43+00:00",
      "home_score": 4,
      "away_score": 3
    }
  ]
}

How to read the payload, and the full workflow, is covered in Tracking Win Probabilities.


Did this page help you?