--- updatedAt: 2026-10-05T19:19:07.000Z agentTools: siteIndex: https://developer.sportradar.com/llms.txt projectIndex: https://developer.sportradar.com/odds/llms.txt --- # OC Prematch Overview Get started with Odds Comparison Prematch API v2 ## Introduction The Prematch API provides aggregated odds data for a wide variety of pre-match betting markets. Top US bookmakers are available, and return odds for NFL, NBA, MLB, top soccer leagues, [and more](https://developer.sportradar.com/odds/reference/oc-prematch-overview#sportsleagues). The API is consistent in structure, format, and behavior with the other General Sport APIs. Primary feeds will return books, categories, sports, and tournaments offered. Additional feeds provide a huge selection of pre-match markets broken down by sport, league, and event.
### New to the Odds Comparison Prematch API? Check out our [Odds Comparison Integration Guide](https://developer.sportradar.com/odds/docs/oc-ig-overview) for common workflows, feed dependencies, and best practices to get up and running.
### Authentication is required for all API calls.
*** ## API Map To best utilize the Odds Comparison Prematch API, you will need specific parameters to create your API calls. The map below shows every feed in the API, grouped by task; the key marks the identifier each feed takes, and each entry links out to its endpoint page. Feeds that require no ID, or only a sport ID and a date, can be called directly. Their responses provide the sport, competition, and sport event IDs that the odds and schedule feeds take. {`
NO ID NEEDEDDATESPORT IDCOMPETITION IDSPORT EVENT IDGetting OrientedSTART HERE ¡ SPORTS PROVIDES THE SPORT IDS Sports Sport Categories Sport Competitions Sport Stages BooksSchedulesDAILY FEEDS TAKE A SPORT ID AND A DATE Daily Schedules Competition SchedulesMonitor Data Changes Sport Event Markets Change LogPrematch OddsSPORT EVENT IDS COME FROM THE SCHEDULE FEEDS Sport Event Markets Daily Sport Event Markets Competition Sport Event MarketsMap IDs to League-Specific APIsPAIRS ODDS URNS WITH LEAGUE-SPECIFIC API IDS Competition Mappings Competitor Mappings Player Mappings Sport Event Mappings Stage Mappings
`} *** ### Endpoint Descriptions **Books** – Returns a list of configured bookmakers and their IDs.  **Competition Schedules** – Provides scheduling info for all events with odds available in a given competition. **Competition Sport Event Markets** – Provides a list of markets for a given competition. **Daily Schedules** – Provides scheduling info for all events with odds available on a given sport and date. **Daily Sport Event Markets** – Provides a list of markets for a given sport and date. **Sport Categories** – Returns a list of categories for a sport ID that have odds available.  **Sport Competitions** – Returns a list of competitions for a sport ID that have odds available.  **Sport Event Markets** – Returns a list of markets for a given sport event. **Sport Event Markets Change Log** – Returns a list of sport events with odds changes in the last 5 minutes. **Sport Stages** – Returns a list of stages and categories for a sport ID that have odds available.  **Sports** – Returns a list of sports and sport IDs.  **Mapping Feeds:** * **Competition Mappings** – Provides competition ID mapping between League Specific and General Sport ID types.  * **Competitor Mappings** – Provides competitor ID mapping between League Specific and General Sport ID types.  * **Player Mappings** – Provides player ID mapping between League Specific and General Sport ID types.  * **Sport Event Mappings** – Provides sport event ID mapping between League Specific and General Sport ID types. * **Stage Mappings** – Provides stage ID mapping between League Specific and General Sport ID types. *** ### Data Retrieval Sample To find 3-way prematch odds for a sport event on a given day:
  1. Call the Sports resource and make note of the Sport Id for your event
  2. Call the Daily Sport Event Markets for your given date, using the Sport Id
  3. Find the Sport Event Id of your event within the results
  4. Call the Sport Event Markets using your located Sport Event Id
  5. The prematch odds for your event are displayed
  6. Find the "1x2" market within the results

*** ## What's Included? See below for included bookmakers, sports, and markets for the **US-focused** version of Prematch odds. For **globally focused** information see our OC Core docs.
### Bookmakers | ID | Name | | :---- | :------------------- | | 25080 | Consensus | | 17324 | MGM | | 18149 | DraftKings | | 18186 | FanDuel | | 27447 | BetRivers | | 27769 | PointsBet | | 28901 | Bet365.US.NJ | | 32219 | WilliamHillNewJersey | | 40316 | ESPNbetCom |
### Sports/Leagues
Sport ID Sport Leagues
2 Basketball NBA WNBA NCAA Men's Basketball
3 Baseball MLB
4 Ice Hockey NHL
16 American Football NFL NCAA
1 Soccer Premier League La Liga Ligue 1 Serie A Bundesliga MLS UEFA Champions League UEFA Champions League - Women UEFA Europa League World Cup Women's World Cup European Championship Liga MX Nations League EFL Cup Championship League One League Two FA Cup Coppa Italia Brazil Serie A Liga Profesional Argentina Scottish Premiership UEFA Conference League

### Markets
Market ID/Name Sports Market Structure
**1** 1x2 American Football Basketball Soccer Team A / Team B / Draw
**11** Draw no Bet Soccer Team A / Team B
**14** Handicap Soccer Team A / Team B / Draw
**18** Total Soccer Team A / Team B
**19** Home Total Ice Hockey Over / Under
**20** Away Total Ice Hockey Over / Under
**23** 2nd Quarter Betting Basketball Team A / Team B
**26** Total Points Odd/Even Basketball Over / Under
**47** Double Result American Football Basketball Tie / Team A, Tie / Team B, Team A / Team B, Team B / Team A, Team A / Team A, Team B / Team B
**60** 1st Half - 1x2 American Football Basketball Team A / Team B / Draw
**64** 1st Half - Draw No Bet American Football Basketball Team A / Team B
**66** 1st Half - Handicap American Football Basketball Team A / Team B
**68** 1st Half - Total American Football Basketball Over / Under
**69** 1st Half - Home Total American Football Over / Under
**70** 1st Half - Away Total American Football Over / Under
**74** 1st Half Total Pts Odd/Even Basketball Even / Odd
**83** 2nd Half Betting American Football Team A / Team B
**94** 2nd Half Total Pts Odd/Even Basketball Even / Odd
**219** Winner (incl. overtime) American Football Basketball
**220** Will There Be Overtime? American Football Basketball Yes / No
**223** Handicap (incl. overtime) American Football Team A / Team B
**225** Total (incl. overtime) American Football Basketball Over / Under
**227** Home Total (incl. overtime) American Football Basketball Over / Under
**228** Away Total (incl. overtime) American Football Basketball Over / Under
**231** 2nd Half - Handicap (incl. overtime) American Football Basketball Team A / Team B
**232** 2nd Half - Total (incl. overtime) American Football Basketball Over / Under
**234** Highest Scoring Quarter American Football 920: First Quarter 921: Second Quarter 922: Third Quarter 923: Fourth Quarter 924: Equal
**235** 1st Quarter Betting American Football Basketball Team A / Team B
**235** 2nd Quarter Betting American Football Basketball Team A / Team B
**235** 3rd Quarter Betting American Football Basketball Team A / Team B
**235** 4th Quarter Betting American Football Basketball Team A / Team B
**236** 1st Quarter Total Points American Football Basketball Over / Under
**236** 2nd Quarter Total Points American Football Basketball Over / Under
**236** 3rd Quarter Total Points American Football Basketball Over / Under
**236** 4th Quarter Total Points American Football Basketball Over / Under
**251** Winner (incl. extra innings) Baseball Team A / Team B
**256** Handicap (incl. extra innings) Baseball Team A / Team B
**260** Home Total (incl. extra innings) Baseball Over / Under
**261** Away Total (incl. extra innings) Baseball Over / Under
**274** Innings 1 to 5 - 1x2 Baseball Team A / Team B / Draw
**275** Innings 1 to 5 - Handicap Baseball Team A / Team B
**276** Innings 1 to 5 - Total Baseball Over / Under
**293** 2nd Half - 1x2 (incl. overtime) American Football Basketball Team A / Team B / Draw
**294** 2nd Half - Draw no Bet (incl. overtime) American Football Basketball Team A / Team B
**302** 1st Quarter Money Line American Football Basketball Team A / Team B
**303** 1st Quarter Spread American Football Basketball Team A / Team B
**303** 2nd Quarter Spread American Football Basketball Team A / Team B
**303** 3rd Quarter Spread American Football Basketball Team A / Team B
**303** 4th Quarter Spread American Football Basketball Team A / Team B
**304** 1st Quarter Total Points Basketball Even / Odd
**304** 2nd Quarter Total Points Basketball Even / Odd
**304** 3rd Quarter Total Points Basketball Even / Odd
**304** 4th Quarter Total Points Basketball Even / Odd
**1123** Inning Winner (1-8) Baseball Team A / Team B
**1124** Innings 1 to 5 - Winner Baseball Team A / Team B
**6022** Will there be a safety? American Football Yes / No
**6023** 1st Half Result / 2nd Half Result American Football (selections from 47) Team A / Tie, Team B / Tie, Team A / Team B, Tie / Team A, Tie / Team B, Team B / Team A, Tie / Tie, Team A / Team A, Team B / Team B
**6024** 1st Team Touchdown American Football 4: Team A 5: Team B 10008: No Touchdown
**6025** 1st Scoring Play American Football 10002: Team A Safety 10003: Team A Field Goal 10004: Team A Touchdown 10005: Team B Safety 10006: Team B Field Goal 10007: Team B Touchdown
**6026** Quarter of 1st Field Goal American Football First Quarter Second Quarter Third Quarter Fourth Quarter 10008: No Field Goal
**6027** Quarter of 1st Touchdown American Football First Quarter Second Quarter Third Quarter Fourth Quarter 10008: No Touchdown
**6028** Score All Quarters? American Football 10009: Team A Yes 10010: Team A No 10011: Team B Yes 10012: Team B No
**6029** Total 1st Half TDs American Football 0, 1, 2, 3, 4, or more
**6030** Total 2nd Half TDs American Football 0, 1, 2, 3, 4, or more
**6031** 1st Half Winning Margin American Football Team A / Team B
**6032** Winning Margin American Football Team A 1-6 pts Team A 7-12 pts Team A 13-18 pts Team A 19-24 pts Team A 25-30 pts Team A 31pts or more Team B 1-6 pts Team B 7-12 pts Team B 13-18 pts Team B 19-24 pts Team B 25-30 pts Team B 31pts or more
**8010** 1st Half Winning Margin Basketball Team A / Team B
**8011** Winning Margin Basketball Team A / Team B

*** ## Integration Resources
### Integration Guide Set up an account, learn the Odds Comparison API basics, study the market model, tackle in-depth integration scenarios, and more by visiting our Odds Comparison Integration Guide!
### OpenAPI Spec Our Odds Comparison Prematch API is available via OpenAPI. Click below to view and/or download the specs. [Odds Comparison Prematch v2 OpenAPI](https://api.sportradar.com/oddscomparison-prematch/trial/v2/openapi/swagger/index.html)
### Postman Workspace ## Run in Postman Our full Media API suite—including the Prematch Odds collection—lives in our public Postman workspace. Fork or follow any collection to get updates automatically.
### Schema Download Open the zip file below to access our entire Odds Comparison Prematch API XSD schema. [Odds Comparison Prematch v2 Schema](https://api-docs.sportradar.us/odds/Odds_Comparison_Prematch_v2.zip)
### MCP Server The **Sportradar Odds Comparison Prematch MCP Server** is a Model Context Protocol (MCP) implementation that bridges AI assistants directly to our OC Prematch API feeds. It allows LLMs to use standardized tools to fetch our sports data, helping to power your applications, assist in coding, and streamlining your integration. For detailed instructions on how to set up and use this integration, visit our MCP Server documentation.