---
updatedAt: 2026-09-22T01:14:01.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/odds/llms.txt
---

# Overview

Odds Comparison v2 delivers pre-match betting odds from multiple bookmakers in one normalized structure. Instead of integrating each sportsbook's feed separately, you call one API per market family and receive every configured bookmaker's current prices, opening prices, and line values side by side, ready to compare.

The product is a family of four packages, each with its own base URL and reference section, all sharing the same conventions, identifiers, and payload shape:

* **Prematch**: main markets for upcoming sport events (money lines, spreads, totals, and their period, half, quarter, and inning splits)
* **Player Props**: player-level markets (for example, a player's total bases, strikeouts, passing yards, or anytime-goalscorer price)
* **Futures**: long-term outright markets (championship winners, division winners, season awards)
* **Live Odds**: in-game odds for live events

Because the packages share one design, everything you learn in this guide about authentication, discovery feeds, the market model, and change tracking applies across all four.

<br />

***

## What the API Provides

* **Aggregated odds** for each market from every bookmaker configured for your key, including a calculated **consensus** line delivered as its own book
* **Three odds formats on every outcome**: decimal, American, and fractional, plus the opening price in all three formats
* **Line values** on handicap and total markets (`handicap`, `total`), with their opening values
* **Change logs** that report which sport events had odds changes in the last five minutes, so you can refresh only what moved
* **Mappings feeds** that translate every Sportradar entity ID to its ID in the League Specific (US) API family, letting you join odds to stats, schedules, and player data

<br />

***

## OC US and OC Core

Odds Comparison v2 is delivered through two access tiers configured at the API key level. Both use the same endpoints and payload shapes; they differ in the bookmaker and sport coverage behind them.

|              | OC US                                                                    | OC Core                                                                                        |
| ------------ | ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| Bookmakers   | A curated, US-focused set                                                | 140+ global bookmakers                                                                         |
| Sports       | Top US leagues (NFL, NBA, MLB, NHL, NCAA) plus major soccer competitions | 30+ sports worldwide                                                                           |
| Markets      | Main markets with their period, half, quarter, and inning splits         | 2-way, 3-way, spread, and total on every covered event, with more where bookmakers supply them |
| Player props | Extensive coverage across NFL, NBA, MLB, NHL, and soccer                 | Soccer goalscorer markets                                                                      |

Your key is provisioned for one tier; contact Sportradar to enable OC Core. Every response identifies the tier serving it in the **`X-Origin-Id`** response header: `MARKET_ORIGIN_MAGIC_CRAWLERS` for OC US, `MARKET_ORIGIN_CORE_CRAWLERS` for OC Core. Bookmaker IDs and sport event IDs are consistent across the two tiers; futures market IDs can differ between them.

<br />

***

## How the Guides Are Organized

The map below shows the three tiers and every page in each; each pill links to its guide.

<div style={{border: "1px solid #C5CAE9", borderRadius: "12px", overflow: "hidden", margin: "4px 0 8px"}}>
  <div style={{background: "linear-gradient(90deg, #1A237E 0%, #283593 60%, #3949AB 100%)", color: "#FFFFFF", padding: "12px 18px", display: "flex", alignItems: "baseline", justifyContent: "space-between", flexWrap: "wrap", gap: "4px 12px"}}>
    <span style={{fontWeight: 700, fontSize: "15px", letterSpacing: "0.02em"}}>Odds Comparison Integration Guide Map</span>
    <span style={{fontSize: "12px", opacity: 0.8}}>Three tiers, top to bottom</span>
  </div>
  <div style={{display: "flex", gap: "12px 14px", padding: "14px 18px", background: "#FFFFFF", borderBottom: "1px solid #E8EAF6", alignItems: "flex-start", flexWrap: "wrap"}}>
    <div style={{display: "flex", alignItems: "center", gap: "8px", flex: "0 0 150px"}}>
      <span style={{background: "#1A237E", color: "#FFFFFF", borderRadius: "50%", width: "22px", height: "22px", display: "inline-flex", alignItems: "center", justifyContent: "center", fontSize: "12px", fontWeight: 700, flexShrink: 0}}>1</span>
      <span style={{fontWeight: 700, fontSize: "12px", color: "#1A237E", textTransform: "uppercase", letterSpacing: "0.05em"}}>Foundational</span>
    </div>
    <div style={{display: "flex", flexWrap: "wrap", gap: "8px", flex: "1 1 320px"}}>
      <span style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", background: "#1A237E", color: "#FFFFFF", fontSize: "13px", fontWeight: 600}}>Overview (you are here)</span>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-api-basics" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>API Basics</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-fundamentals" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Fundamentals</a>
    </div>
  </div>
  <div style={{display: "flex", gap: "12px 14px", padding: "14px 18px", background: "#FFFFFF", borderBottom: "1px solid #E8EAF6", alignItems: "flex-start", flexWrap: "wrap"}}>
    <div style={{display: "flex", alignItems: "center", gap: "8px", flex: "0 0 150px"}}>
      <span style={{background: "#283593", color: "#FFFFFF", borderRadius: "50%", width: "22px", height: "22px", display: "inline-flex", alignItems: "center", justifyContent: "center", fontSize: "12px", fontWeight: 700, flexShrink: 0}}>2</span>
      <span style={{fontWeight: 700, fontSize: "12px", color: "#1A237E", textTransform: "uppercase", letterSpacing: "0.05em"}}>Core Concepts</span>
    </div>
    <div style={{display: "flex", flexWrap: "wrap", gap: "8px", flex: "1 1 320px"}}>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-id-handling" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>ID Handling</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-update-frequencies" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Update Frequencies</a>
    </div>
  </div>
  <div style={{display: "flex", gap: "12px 14px", padding: "14px 18px", background: "#FFFFFF", alignItems: "flex-start", flexWrap: "wrap"}}>
    <div style={{display: "flex", alignItems: "center", gap: "8px", flex: "0 0 150px"}}>
      <span style={{background: "#3949AB", color: "#FFFFFF", borderRadius: "50%", width: "22px", height: "22px", display: "inline-flex", alignItems: "center", justifyContent: "center", fontSize: "12px", fontWeight: 700, flexShrink: 0}}>3</span>
      <span style={{fontWeight: 700, fontSize: "12px", color: "#1A237E", textTransform: "uppercase", letterSpacing: "0.05em"}}>Scenarios</span>
    </div>
    <div style={{display: "flex", flexWrap: "wrap", gap: "8px", flex: "1 1 320px"}}>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-scenarios" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #2962FF", background: "#F3F6FA", color: "#0034C2", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Integration Scenarios (start here)</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-pulling-prematch-odds" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Pulling Prematch Odds</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-retrieving-player-props" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Retrieving Player Props</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-tracking-futures" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Tracking Futures Odds</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-tracking-live-odds" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Tracking Live Odds</a>
      <a href="https://developer.sportradar.com/odds/docs/oc-ig-monitoring-odds-changes" style={{display: "inline-block", padding: "5px 12px", borderRadius: "999px", border: "1px solid #C5CAE9", background: "#F3F6FA", color: "#1A237E", fontSize: "13px", fontWeight: 600, textDecoration: "none"}}>Monitoring Odds Changes</a>
    </div>
  </div>
  <div style={{padding: "10px 18px", background: "#FAFAFA", borderTop: "1px solid #E8EAF6", fontSize: "12px", color: "#6B7280"}}>The scenario pages cover all four packages; every page builds on the shared foundations above it.</div>
</div>

Looking for event win probabilities rather than bookmaker odds? Those are served by the separate [Probabilities API](https://developer.sportradar.com/odds/docs/probabilities-ig-overview), which shares its sport event IDs with Odds Comparison.

<br />

***

## A 60-Second Look at the Data

One market from a Prematch response shows the shape you will work with everywhere: a market, the books offering it, and each book's outcomes carrying all three odds formats plus the opening price.

```json Sport Event Markets (json)
{
  "markets": [
    {
      "id": "sr:market:256",
      "name": "handicap (incl. extra innings)",
      "is_live": false,
      "books": [
        {
          "id": "sr:book:17324",
          "name": "MGM",
          "removed": false,
          "external_sport_event_id": "19803922",
          "external_market_id": "1542773886",
          "outcomes": [
            {
              "id": "sr:outcome:1714",
              "type": "home_handicap",
              "odds_decimal": "1.570",
              "odds_american": "-175",
              "odds_fraction": "4/7",
              "open_odds_decimal": "1.550",
              "open_odds_american": "-182",
              "open_odds_fraction": "11/20",
              "handicap": "1.5",
              "open_handicap": "1.5",
              "external_outcome_id": "2253398335",
              "removed": false
            },
            {
              "id": "sr:outcome:1715",
              "type": "away_handicap",
              "odds_decimal": "2.450",
              "odds_american": "+145",
              "odds_fraction": "29/20",
              "open_odds_decimal": "2.500",
              "open_odds_american": "+150",
              "open_odds_fraction": "3/2",
              "handicap": "-1.5",
              "open_handicap": "-1.5",
              "external_outcome_id": "2253398334",
              "removed": false
            }
          ]
        }
      ]
    }
  ]
}
```

The response above is trimmed to a single book; the full payload carries every configured bookmaker for all 27 markets of this game. How to read it, and every field's meaning, is covered in [Fundamentals](https://developer.sportradar.com/odds/docs/oc-ig-fundamentals).