# Table of Contents - [The Odds API](#the-odds-api) - [The Odds API](#the-odds-api) - [API Rate Limit (status code 429) | The Odds API](#api-rate-limit-status-code-429-the-odds-api) - [Odds API Code Samples V3 | The Odds API](#odds-api-code-samples-v3-the-odds-api) - [Cancel Subscription | The Odds API](#cancel-subscription-the-odds-api) - [The Odds API](#the-odds-api) - [Sports Odds Data for Excel | The Odds API](#sports-odds-data-for-excel-the-odds-api) - [Sports Odds Data for Google Sheets | The Odds API](#sports-odds-data-for-google-sheets-the-odds-api) - [The Odds API](#the-odds-api) - [Integrating Odds on Your Website | The Odds API](#integrating-odds-on-your-website-the-odds-api) - [The Odds API](#the-odds-api) - [Historical Sports Odds Data API | The Odds API](#historical-sports-odds-data-api-the-odds-api) - [Odds API Code Samples V4 | The Odds API](#odds-api-code-samples-v4-the-odds-api) - [Odds API Docs V3 | The Odds API](#odds-api-docs-v3-the-odds-api) - [Sports Odds API | The Odds API](#sports-odds-api-the-odds-api) - [Odds API Documentation V4 | The Odds API](#odds-api-documentation-v4-the-odds-api) - [The Odds API FAQs | The Odds API](#the-odds-api-faqs-the-odds-api) - [Odds Widget FAQs | The Odds API](#odds-widget-faqs-the-odds-api) - [API Error Codes | The Odds API](#api-error-codes-the-odds-api) - [Support for CORS - The Odds API | The Odds API](#support-for-cors-the-odds-api-the-odds-api) - [Update Credit Card | The Odds API](#update-credit-card-the-odds-api) - [Google Sheets Add-on Errors | The Odds API](#google-sheets-add-on-errors-the-odds-api) - [The Odds API - Bookmaker Deep Links | The Odds API](#the-odds-api-bookmaker-deep-links-the-odds-api) - [How to Cancel | The Odds API](#how-to-cancel-the-odds-api) - [Privacy Policy | The Odds API](#privacy-policy-the-odds-api) - [Odds API Game Id | The Odds API](#odds-api-game-id-the-odds-api) - [Odds API Outrights & Futures | The Odds API](#odds-api-outrights-futures-the-odds-api) - [Bets API | The Odds API](#bets-api-the-odds-api) - [Sports Odds Data | The Odds API](#sports-odds-data-the-odds-api) - [Showcase - The Odds API | The Odds API](#showcase-the-odds-api-the-odds-api) - [The Odds API](#the-odds-api) - [The Odds API - Rotation Numbers | The Odds API](#the-odds-api-rotation-numbers-the-odds-api) - [List of API Betting Markets | The Odds API](#list-of-api-betting-markets-the-odds-api) - [How to Monetize Odds Data | The Odds API](#how-to-monetize-odds-data-the-odds-api) - [Odds Formats | The Odds API](#odds-formats-the-odds-api) - [Football Odds API | The Odds API](#football-odds-api-the-odds-api) - [Odds API Update Interval | The Odds API](#odds-api-update-interval-the-odds-api) - [Sports APIs | The Odds API](#sports-apis-the-odds-api) - [Betting Markets - Examples | The Odds API](#betting-markets-examples-the-odds-api) - [Terms and Conditions | The Odds API](#terms-and-conditions-the-odds-api) - [Football Betting Data | The Odds API](#football-betting-data-the-odds-api) - [Live Sports Odds | The Odds API](#live-sports-odds-the-odds-api) - [Bookmaker APIs | The Odds API](#bookmaker-apis-the-odds-api) - [How to add sports odds widget to websites | The Odds API](#how-to-add-sports-odds-widget-to-websites-the-odds-api) - [EPL Odds API | The Odds API](#epl-odds-api-the-odds-api) - [MLB Odds API | The Odds API](#mlb-odds-api-the-odds-api) - [NCAA Basketball Odds API | The Odds API](#ncaa-basketball-odds-api-the-odds-api) - [NBA Odds API | The Odds API](#nba-odds-api-the-odds-api) - [NHL Odds API | The Odds API](#nhl-odds-api-the-odds-api) - [UFC - MMA Odds API | The Odds API](#ufc-mma-odds-api-the-odds-api) - [WNBA Odds API | The Odds API](#wnba-odds-api-the-odds-api) - [NCAA Football Odds API | The Odds API](#ncaa-football-odds-api-the-odds-api) - [AHL Odds API | The Odds API](#ahl-odds-api-the-odds-api) - [Boxing Odds API | The Odds API](#boxing-odds-api-the-odds-api) - [MMA/UFC Odds API | The Odds API](#mma-ufc-odds-api-the-odds-api) - [NCAA Lacrosse Odds API | The Odds API](#ncaa-lacrosse-odds-api-the-odds-api) - [Odds Widget Builder V1 | The Odds API](#odds-widget-builder-v1-the-odds-api) - [NFL Odds API | The Odds API](#nfl-odds-api-the-odds-api) - [AFL Odds API | The Odds API](#afl-odds-api-the-odds-api) - [NCAA Baseball Odds API | The Odds API](#ncaa-baseball-odds-api-the-odds-api) - [EPL Odds API | The Odds API](#epl-odds-api-the-odds-api) - [NFL Preseason Odds API | The Odds API](#nfl-preseason-odds-api-the-odds-api) - [Tennis Odds API | The Odds API](#tennis-odds-api-the-odds-api) - [Odds Widget Docs V1 | The Odds API](#odds-widget-docs-v1-the-odds-api) - [MLB Odds API | The Odds API](#mlb-odds-api-the-odds-api) - [UFL Odds API | The Odds API](#ufl-odds-api-the-odds-api) - [PLL Odds API | The Odds API](#pll-odds-api-the-odds-api) - [WNCAAB Odds API | The Odds API](#wncaab-odds-api-the-odds-api) - [NBA Odds API | The Odds API](#nba-odds-api-the-odds-api) - [Odds Widget | The Odds API](#odds-widget-the-odds-api) - [NHL Odds API | The Odds API](#nhl-odds-api-the-odds-api) - [NCAA Basketball Odds API | The Odds API](#ncaa-basketball-odds-api-the-odds-api) - [NFL Odds API | The Odds API](#nfl-odds-api-the-odds-api) - [NCAAF Odds API | The Odds API](#ncaaf-odds-api-the-odds-api) - [WNBA Odds API | The Odds API](#wnba-odds-api-the-odds-api) - [The Odds API](#the-odds-api) - [The Odds API](#the-odds-api) --- # The Odds API This version has been deprecated. See [version 4](https://the-odds-api.com/liveapi/guides/v4) --- # The Odds API Redirecting to [https://dash.the-odds-api.com/](https://dash.the-odds-api.com/) ... --- # API Rate Limit (status code 429) | The Odds API [#](https://the-odds-api.com/guide/rate-limit.html#api-rate-limit-status-code-429) API Rate Limit (status code 429) ==================================================================================================================== Rate limiting protects our systems from sudden bursts in traffic. When a request is rate limited, the API returns a 429 error code. The current rate limit is 30 requests per second on all usage plans. Even if you send requests below the rate limit, you might still encounter 429 errors sometimes. There are a couple of reasons for this: * If our system receives a large increase in traffic, it will take some time to scale up, usually in the order of minutes. While this is happening, some requests might be knocked back with 429s. * If requests are sent at a rate close to the limit, some requests can still trigger rate limiting since our servers can receive requests at a different rate to which they are sent. For example, if you send 30 requests per second for 2 seconds, our servers might receive 25 requests in the first second, 33 in the next second (3 of which will be limited), and the remaining 2 requests after that. The rate at which our systems receive the requests will depend on network conditions, which are influenced by many factors outside of our control. Both of these scenarios mean that 429s can occur sometimes, and they are more likely if requests are being sent close to the limit. To handle a request that has been rate limited, consider retrying the request after a couple of seconds. Also avoid unnecessary API calls. For example, API calls to the sports or events endpoints can be made infrequently, since the responses don't change often. [#](https://the-odds-api.com/guide/rate-limit.html#reduce-the-likelihood-of-429s) Reduce the likelihood of 429s ---------------------------------------------------------------------------------------------------------------- 1. It is highly recommended to combine multiple markets in the same request if you are not already doing so. Markets can be combined with a comma separator. ❌ If you need multiple markets, don't send one request per market https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?markets=h2h https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?markets=spreads ✅ Instead, combine markets into a single request using comma separators in the markets parameter https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?markets=h2h,spreads The same applies if you are querying multiple regions. 2. Reduce calls to endpoints that don't update frequently, such as `/sports` or `/events` endpoints. This can be done by caching the responses. The cache duration will depend on the needs of your application. For example, you might cache the `/sports` response for an hour, and the `/events` endpoint for 10 minutes. 3. If an endpoint returns empty results (for example, immediately after a round of games, or if the sport is out of season), send requests less frequently until games become available again. [#](https://the-odds-api.com/guide/rate-limit.html#summary) Summary -------------------------------------------------------------------- * Send requests below the rate limit * Expect 429s sometimes, especially if sending requests close to the rate limit. When a 429 is encountered, retry the request after a couple of seconds. If possible, space requests out over a longer time period rather than sending many requests in short bursts. * If you are querying multiple markets, ensure markets are combined into a single request rather than sending one request per market. The same applies to regions. * Send less frequent requests to endpoints that don't update frequently, such as the `/sports` and `/events` endpoints. Save or cache the response for use in between requests. * Send less frequent requests to endpoints that aren't returning any data --- # Odds API Code Samples V3 | The Odds API [#](https://the-odds-api.com/liveapi/guides/v3/samples.html#code-samples-v3) Code Samples V3 ============================================================================================= The Odds API is easy to use with your favorite coding language. We've included simple Python and Node.js code examples to help you get started. Be sure to specify your api key in order for the examples to work. Get a [free API key here](https://the-odds-api.com/#get-access) . For more details, see the [API docs](https://the-odds-api.com/liveapi/guides/v3/index.html) . Code samples are also available on [Github (opens new window)](https://github.com/the-odds-api) [#](https://the-odds-api.com/liveapi/guides/v3/samples.html#python) Python --------------------------------------------------------------------------- Note This example uses python's [requests library (opens new window)](http://docs.python-requests.org/en/master/) , which can be installed with `pip install requests` Security Tip for Repl.it users This example uses [Repl.it (opens new window)](https://repl.it/) \* to run live code. If you continue coding using a free Repl.it account, anyone visiting your Repl.it repo might see your api key. To make sure it stays secret, create a file called `.env` containing `api_key=YOUR_API_KEY` Back in main.py, bring in your api key with: import os api_key = os.getenv("api_key") For more info, see the [Repl.it docs (opens new window)](https://repl.it/site/docs/repls/secret-keys) \* The Odds API is not affiliated with Repl.it in any way This code sample can also be found on [Github (opens new window)](https://github.com/the-odds-api/samples-python) [#](https://the-odds-api.com/liveapi/guides/v3/samples.html#node-js) Node.js ----------------------------------------------------------------------------- Note This example uses Node's [axios library (opens new window)](https://www.npmjs.com/package/axios) , which can be installed with `npm install axios` or `bower install axios` Security Tip for Repl.it users This example uses [Repl.it (opens new window)](https://repl.it/) \* to run live code. If you continue coding using a free Repl.it account, anyone visiting your Repl.it repo might see your api key. To make sure it stays secret, create a file called `.env` containing `api_key=YOUR_API_KEY` Back in index.js, bring in your api key with: const api_key = process.env.api_key For more info, see the [Repl.it docs (opens new window)](https://repl.it/site/docs/repls/secret-keys) \* The Odds API is not affiliated with Repl.it in any way This code sample can also be found on [Github (opens new window)](https://github.com/the-odds-api/samples-nodejs) --- # Cancel Subscription | The Odds API [#](https://the-odds-api.com/manage/cancel.html#cancel-subscription) Cancel Subscription ========================================================================================= To cancel your subscription, you need to provide your API key and the email address you subscribed with. Your subscription will automatically cancel before the next billing cycle. SUBMIT --- # The Odds API This version has been deprecated. See [version 4](https://the-odds-api.com/liveapi/guides/v4) --- # Sports Odds Data for Excel | The Odds API [#](https://the-odds-api.com/features/excel.html#page-frontmatter-title) Sports Odds Data for Excel ==================================================================================================== Get live sports odds data into Excel™ spreadsheets at the click of a button with the [The Odds API add-on (opens new window)](https://store.office.com/en-us/app.aspx?assetid=WA104380819&sourcecorrid=cf8fc15c-ea73-47af-b898-b8513c4e8384&ui=en-US&rs=en-US&ad=US&appredirect=false) . No programming skills needed! ![Sports odds data in Excel](https://the-odds-api.com/assets/img/sports-odds-in-excel.gif) Get Add On → Select the sport and region you want to see, and watch your Excel spreadsheet populate with sports odds data from different bookmakers. Sports odds data covers live and upcoming sports games for several bookmakers. To learn more about the sports and bookmakers we cover, [see here](https://the-odds-api.com/) . Available for Excel 2016+ and [Excel Online (opens new window)](https://office.live.com/start/Excel.aspx) Prefer Google Sheets? Check out the [Google Sheets add-on](https://the-odds-api.com/features/spreadsheets.html) [#](https://the-odds-api.com/features/excel.html#get-started) Get Started -------------------------------------------------------------------------- You'll need 1. A Live Odds API Key ([start for free](https://the-odds-api.com/) ) 2. The Excel add-on ([free download (opens new window)](https://store.office.com/en-us/app.aspx?assetid=WA104380819&sourcecorrid=cf8fc15c-ea73-47af-b898-b8513c4e8384&ui=en-US&rs=en-US&ad=US&appredirect=false) ) And that's it. Get started today! --- # Sports Odds Data for Google Sheets | The Odds API [#](https://the-odds-api.com/features/spreadsheets.html#page-frontmatter-title) Sports Odds Data for Google Sheets =================================================================================================================== Get live sports odds data in Google Sheets at the click of a button with the [The Odds API add-on (opens new window)](https://workspace.google.com/marketplace/app/sports_odds_plus/648207346109) . No programming skills needed! ![Sports odds data in Google Sheets](https://the-odds-api.com/assets/img/sports-odds-in-sheets.gif) Get Add On → Select the sport and region you want to see, and watch your spreadsheet populate with current sports odds data from different bookmakers. Sports odds data covers live and upcoming sports games for several bookmakers. To learn more about the sports and bookmakers we cover, [see here](https://the-odds-api.com/) . Prefer Microsoft Excel? Check out the [Excel add-on](https://the-odds-api.com/features/excel.html) [#](https://the-odds-api.com/features/spreadsheets.html#get-started) Get Started --------------------------------------------------------------------------------- You'll need 1. A Live Odds API Key ([start for free](https://the-odds-api.com/) ) 2. The Google Sheets add-on ([free download (opens new window)](https://workspace.google.com/marketplace/app/sports_odds_plus/648207346109) ) And that's it. Get started today! ![Works with google drive](https://the-odds-api.com/assets/img/works-with-google-drive-white.png) --- # The Odds API Redirecting to [https://dash.the-odds-api.com/](https://dash.the-odds-api.com/) ... --- # Integrating Odds on Your Website | The Odds API [#](https://the-odds-api.com/guide/website-odds-integration.html#integrating-odds-on-your-website) Integrating Odds on Your Website ==================================================================================================================================== Choose the best method to display sports betting odds on your website. ### [#](https://the-odds-api.com/guide/website-odds-integration.html#option-1-odds-widget) Option 1: Odds Widget The widget is a simple HTML tag that displays bookmaker odds on your website with your own affiliate links. When users click the widget, they're directed to the bookmaker's website using your attribution. **How it works:** Copy and paste an HTML tag into your website's code. You can monetize your website by including bookmaker affiliate links in the widget. The widget is the simplest option but provides limited customization. [Get started with the odds widget](https://the-odds-api.com/widget/) ### [#](https://the-odds-api.com/guide/website-odds-integration.html#option-2-odds-api) Option 2: Odds API The API provides access to raw odds data for custom implementations. It offers much more flexibility than the widget, but requires development effort or coding experience. **How it works:** Use the API to build your own odds display and features. You'll need coding experience or access to developers to implement a custom solution. [Get started with the odds API](https://the-odds-api.com/liveapi/guides/v4/) ### [#](https://the-odds-api.com/guide/website-odds-integration.html#widget-vs-api-comparison) Widget vs API Comparison **Widget Pros & Cons** * ✅ Simple setup and integration on websites * ✅ Monetize with your own bookmaker affiliate links * ❌ Limited functionality - only shows a single bookmaker's odds for primary markets * ❌ Fixed UI - structure and styles cannot be customized **API Pros & Cons** * ✅ Full customization of data and UI * ✅ Access any supported bookmakers and markets * ✅ Can build advanced features and analytics * ❌ Requires coding experience or developer resources --- # The Odds API Redirecting to [https://dash.the-odds-api.com/](https://dash.the-odds-api.com/) ... --- # Historical Sports Odds Data API | The Odds API [#](https://the-odds-api.com/historical-odds-data/#historical-odds-data) Historical Odds Data ============================================================================================== Historical odds data is available for all sports and bookmakers covered by The Odds API. Historical data is available as snapshots, which include events and bookmaker odds as they were at a point in time. Historical odds data for [featured markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#featured-betting-markets) is available from June 6th 2020, with snapshots taken at 10 minute intervals. From September 2022, historical odds snapshots are available at 5 minute intervals. Historical odds data for [additional markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#additional-markets) , including player props, period markets and more, is available from May 3rd, 2023. Snapshots are available at 5 minute intervals. Historical data is only available on paid usage plans. [#](https://the-odds-api.com/historical-odds-data/#how-to-access-historical-odds-data) How to access historical odds data -------------------------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/historical-odds-data/#historical-odds-data-for-featured-markets) Historical odds data for featured markets [Featured markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) include the most popular betting markets and are prominently displayed by bookmakers. Historical odds data for featured markets is available in JSON format using the API's [historical odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds) . ##### [#](https://the-odds-api.com/historical-odds-data/#example-api-request) Example API Request The input parameters are the same as those of the [v4 odds API endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) , with the addition of a `date` parameter which represents the timestamp of the snapshot to be queried. The historical odds API will return the closest snapshot equal to or earlier than the provided `date` parameter. The usage quota cost for the historical odds endpoint is 10 per region per market ([more info](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-6) ). GET https://api.the-odds-api.com/v4/historical/sports/americanfootball_nfl/odds?regions=us&oddsFormat=american&apiKey=YOUR_API_KEY&date=2021-10-18T12:00:00Z ##### [#](https://the-odds-api.com/historical-odds-data/#example-api-response) Example API Response The response schema is the same as that of the [v4 odds API endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) , but wrapped in a structure that contains information about the snapshot, including: * timestamp: The timestamp of the snapshot. This will be the closest available timestamp equal to or earlier than the provided `date` parameter. * previous\_timestamp: the preceding available timestamp. This can be used as the `date` parameter in a new request to move back in time. * next\_timestamp: The next available timestamp. This can be used as the `date` parameter in a new request to move forward in time. { "timestamp": "2021-10-18T11:55:00Z", "previous_timestamp": "2021-10-18T11:45:00Z", "next_timestamp": "2021-10-18T12:05:00Z", "data": [\ {\ "id": "4edd5ce090a3ec6192053b10d27b87b0",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2021-10-19T00:15:00Z",\ "home_team": "Tennessee Titans",\ "away_team": "Buffalo Bills",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2021-10-18T11:48:09Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -294\ },\ {\ "name": "Tennessee Titans",\ "price": 230\ }\ ]\ }\ ]\ },\ ...\ \ ### [#](https://the-odds-api.com/historical-odds-data/#historical-odds-data-for-additional-markets)\ Historical odds data for additional markets\ \ Historical odds data for [additional markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#additional-markets)\ , including player props, half/quarter time markets and more, can be queried one game at a time using the [historical event odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-event-odds)\ .\ \ ##### [#](https://the-odds-api.com/historical-odds-data/#example-api-request-2)\ Example API Request\ \ The input parameters are the same as those of the [v4 event-odds API endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ , with the addition of a `date` parameter which represents the timestamp of the snapshot to be queried. The historical odds API will return the closest snapshot equal to or earlier than the provided `date` parameter. The usage quota cost for the historical event-odds endpoint is 10 per region per market per event ([more info](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-8)\ ).\ \ In this example, da359da99aa27e97d38f2df709343998 is the id of the Lakers @ Pistons game on 2023-11-30. The [historical events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-events)\ can be used to find event ids.\ \ GET https://api.the-odds-api.com/v4/historical/sports/basketball_nba/events/da359da99aa27e97d38f2df709343998/odds?apiKey=YOUR_API_KEY&date=2023-11-29T22:45:00Z®ions=us&markets=player_points,h2h_q1\ \ \ ##### [#](https://the-odds-api.com/historical-odds-data/#example-api-response-2)\ Example API Response\ \ The response schema is the same as that of the [v4 event-odds API endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ , but wrapped in a structure that contains information about the snapshot, including:\ \ * timestamp: The timestamp of the snapshot. This will be the closest available timestamp equal to or earlier than the provided `date` parameter.\ * previous\_timestamp: the preceding available timestamp. This can be used as the `date` parameter in a new request to move back in time.\ * next\_timestamp: The next available timestamp. This can be used as the `date` parameter in a new request to move forward in time.\ \ {\ "timestamp": "2023-11-29T22:40:39Z",\ "previous_timestamp": "2023-11-29T22:35:39Z",\ "next_timestamp": "2023-11-29T22:45:40Z",\ "data": {\ "id": "da359da99aa27e97d38f2df709343998",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2023-11-30T00:10:00Z",\ "home_team": "Detroit Pistons",\ "away_team": "Los Angeles Lakers",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-11-29T22:40:09Z",\ "markets": [\ {\ "key": "h2h_q1",\ "last_update": "2023-11-29T22:40:55Z",\ "outcomes": [\ {\ "name": "Detroit Pistons",\ "price": 2.5\ },\ {\ "name": "Los Angeles Lakers",\ "price": 1.56\ }\ ]\ },\ {\ "key": "player_points",\ "last_update": "2023-11-29T22:40:55Z",\ "outcomes": [\ {\ "name": "Over",\ "description": "Anthony Davis",\ "price": 1.83,\ "point": 23.5\ },\ {\ "name": "Under",\ "description": "Anthony Davis",\ "price": 1.91,\ "point": 23.5\ },\ {\ "name": "Over",\ "description": "Ausar Thompson",\ "price": 1.87,\ "point": 11.5\ },\ {\ "name": "Under",\ "description": "Ausar Thompson",\ "price": 1.87,\ "point": 11.5\ },\ {\ "name": "Over",\ "description": "Cade Cunningham",\ "price": 1.91,\ "point": 23.5\ },\ {\ "name": "Under",\ "description": "Cade Cunningham",\ "price": 1.83,\ "point": 23.5\ },\ {\ "name": "Over",\ "description": "D'Angelo Russell",\ "price": 1.87,\ "point": 14.5\ },\ ...\ \ [#](https://the-odds-api.com/historical-odds-data/#sample-historical-odds-data)\ Sample Historical Odds Data\ ------------------------------------------------------------------------------------------------------------\ \ The historical odds API is only available on paid subscriptions at this time. This section provides examples of API requests and responses to demonstrate usage of the historical odds API.\ \ This section only covers a small selection of sports. Historical odds data is available for all sports covered in the API from the time the sport was added to the API. [See the full list of sports. (opens new window)](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ .\ \ #### [#](https://the-odds-api.com/historical-odds-data/#historical-nfl-odds-data)\ Historical NFL odds data\ \ * Moneyline (h2h), point spreads (spreads) and over/under (totals)\ * US bookmakers\ * Snapshot date 2021-11-25T12:00:00Z\ * American odds format\ \ Request:\ \ https://api.the-odds-api.com/v4/historical/sports/americanfootball_nfl/odds?apiKey=YOUR_API_KEY®ions=us&markets=h2h,spreads,totals&oddsFormat=american&date=2021-11-25T12:00:00Z\ \ \ Response: [Download historical odds API response for NFL](https://public-odds-api-sample-data.s3.amazonaws.com/historical-nfl.json)\ \ #### [#](https://the-odds-api.com/historical-odds-data/#historical-epl-odds-data)\ Historical EPL odds data\ \ * 1x2 (h2h)\ * UK bookmakers\ * Date 2021-10-30T00:00:00Z\ * Decimal odds format\ \ Request:\ \ https://api.the-odds-api.com/v4/historical/sports/soccer_epl/odds?apiKey=YOUR_API_KEY®ions=uk&markets=h2h&date=2021-10-30T00:00:00Z\ \ \ Response: [Download historical odds API response for EPL](https://public-odds-api-sample-data.s3.amazonaws.com/historical-epl.json)\ \ #### [#](https://the-odds-api.com/historical-odds-data/#historical-german-bundesliga-odds-data)\ Historical German Bundesliga odds data\ \ * 1x2 (h2h)\ * EU bookmakers\ * Date 2022-10-18T02:00:00Z\ * Decimal odds format\ \ Request:\ \ https://api.the-odds-api.com/v4/historical/sports/soccer_germany_bundesliga/odds?apiKey=YOUR_API_KEY®ions=eu&markets=h2h&date=2022-10-18T02:00:00Z\ \ \ Response: [Download historical odds API response for Bundesliga](https://public-odds-api-sample-data.s3.amazonaws.com/historical-bundesliga.json)\ \ #### [#](https://the-odds-api.com/historical-odds-data/#historical-afl-odds-data)\ Historical AFL odds data\ \ * Head to head (h2h)\ * AU bookmakers\ * Date 2022-04-25T00:00:00Z\ * Decimal odds format\ \ Request:\ \ https://api.the-odds-api.com/v4/historical/sports/aussierules_afl/odds?apiKey=YOUR_API_KEY®ions=au&markets=h2h&date=2022-04-25T00:00:00Z\ \ \ Response: [Download historical odds API response for AFL](https://public-odds-api-sample-data.s3.amazonaws.com/historical-afl.json)\ \ #### [#](https://the-odds-api.com/historical-odds-data/#historical-us-presidential-elections-winner-odds-data)\ Historical US presidential elections winner odds data\ \ * Futures (outrights)\ * US bookmakers\ * Date 2020-10-31T00:00:00Z (note coverage of US bookmakers was limited in 2020)\ * American odds format\ \ Request:\ \ https://api.the-odds-api.com/v4/historical/sports/politics_us_presidential_election_winner/odds?apiKey=YOUR_API_KEY®ions=us&oddsFormat=american&date=2020-10-31T00:00:00Z\ \ \ Response: [Download historical odds API response for US Presidential Election Winner](https://public-odds-api-sample-data.s3.amazonaws.com/historical-us-presidential-election-winner.json)\ \ [#](https://the-odds-api.com/historical-odds-data/#earliest-historical-timestamps)\ Earliest Historical Timestamps\ ------------------------------------------------------------------------------------------------------------------\ \ Historical data will only be available from the time that coverage is added for a sport, bookmaker or market. The list below shows the earliest available timestamp of historical odds for each covered sport.\ \ | Group | League / Tournament | Sport Key
(use in the API) | Start of Historical Data |\ | --- | --- | --- | --- |\ | American Football | CFL | americanfootball\_cfl | 2022-07-02T00:45:00Z |\ | American Football | NCAAF | americanfootball\_ncaaf | 2020-06-06T10:05:00Z |\ | American Football | NCAAF Championship Winner | americanfootball\_ncaaf\_championship\_winner | 2023-10-24T05:40:42Z |\ | American Football | NFL | americanfootball\_nfl | 2020-06-06T10:05:00Z |\ | American Football | NFL Preseason | americanfootball\_nfl\_preseason | 2022-07-29T12:05:00Z |\ | American Football | NFL Super Bowl Winner | americanfootball\_nfl\_super\_bowl\_winner | 2020-06-06T10:05:00Z |\ | American Football | UFL | americanfootball\_ufl | 2023-02-21T21:00:39Z |\ | Aussie Rules | AFL | aussierules\_afl | 2020-06-06T10:05:00Z |\ | Baseball | MLB | baseball\_mlb | 2020-06-30T20:55:00Z |\ | Baseball | MLB Preseason | baseball\_mlb\_preseason | 2023-02-28T11:10:39Z |\ | Baseball | MLB World Series Winner | baseball\_mlb\_world\_series\_winner | 2021-11-07T09:55:00Z |\ | Baseball | Minor League Baseball | baseball\_milb | 2024-04-10T01:40:39Z |\ | Baseball | NPB | baseball\_npb | 2024-03-28T21:10:40Z |\ | Baseball | KBO League | baseball\_kbo | 2024-03-28T21:10:40Z |\ | Baseball | NCAA Baseball | baseball\_ncaa | 2023-05-03T22:50:40Z |\ | Basketball | Basketball Euroleague | basketball\_euroleague | 2020-09-24T00:25:00Z |\ | Basketball | NBA | basketball\_nba | 2020-06-27T03:55:00Z |\ | Basketball | NBA Preseason | basketball\_nba\_preseason | 2022-10-07T00:05:40Z |\ | Basketball | NBA Summer League | basketball\_nba\_summer\_league | 2025-07-05T05:55:38Z |\ | Basketball | NBA Championship Winner | basketball\_nba\_championship\_winner | 2021-11-07T09:55:00Z |\ | Basketball | WNBA | basketball\_wnba | 2022-05-21T09:05:00Z |\ | Basketball | NCAAB | basketball\_ncaab | 2020-11-16T09:15:00Z |\ | Basketball | WNCAAB | basketball\_wncaab | 2024-11-12T21:15:38Z |\ | Basketball | NCAAB Championship Winner | basketball\_ncaab\_championship\_winner | 2023-10-24T05:45:43Z |\ | Basketball | NBL (Australia) | basketball\_nbl | 2024-09-24T05:05:38Z |\ | Boxing | Boxing | boxing\_boxing | 2023-05-30T01:10:40Z |\ | Cricket | Asia Cup | cricket\_asia\_cup | 2022-08-10T09:45:00Z |\ | Cricket | Big Bash | cricket\_big\_bash | 2020-11-06T10:55:00Z |\ | Cricket | Caribbean Premier League | cricket\_caribbean\_premier\_league | 2022-09-13T00:15:00Z |\ | Cricket | ICC Champions Trophy | cricket\_icc\_trophy | 2025-02-22T10:55:39Z |\ | Cricket | ICC World Cup | cricket\_icc\_world\_cup | 2022-09-13T00:25:00Z |\ | Cricket | ICC Women's World Cup | cricket\_icc\_world\_cup\_womens | 2022-09-13T00:25:00Z |\ | Cricket | International Twenty20 | cricket\_international\_t20 | 2022-08-10T09:45:00Z |\ | Cricket | IPL | cricket\_ipl | 2020-09-18T11:55:00Z |\ | Cricket | One Day Internationals | cricket\_odi | 2020-07-06T18:15:00Z |\ | Cricket | Pakistan Super League | cricket\_psl | 2023-02-10T23:35:38Z |\ | Cricket | T20 Blast | cricket\_t20\_blast | 2023-06-07T06:50:38Z |\ | Cricket | Test Matches | cricket\_test\_match | 2020-06-06T10:05:00Z |\ | Cricket | The Hundred | cricket\_the\_hundred | 2022-08-10T09:45:00Z |\ | Golf | Masters Tournament Winner | golf\_masters\_tournament\_winner | 2020-06-06T10:05:00Z |\ | Golf | PGA Championship Winner | golf\_pga\_championship\_winner | 2020-06-06T10:05:00Z |\ | Golf | The Open Winner | golf\_the\_open\_championship\_winner | 2021-04-06T22:05:00Z |\ | Golf | US Open Winner | golf\_us\_open\_winner | 2020-06-06T10:05:00Z |\ | Handball | Handball-Bundesliga | handball\_germany\_bundesliga | 2025-10-11T08:25:39Z |\ | Ice Hockey | NHL | icehockey\_nhl | 2020-06-29T19:25:00Z |\ | Ice Hockey | NHL Preseason | icehockey\_nhl\_preseason | 2025-09-29T20:15:39Z |\ | Ice Hockey | AHL | icehockey\_ahl | 2025-02-10T05:20:37Z |\ | Ice Hockey | NHL Championship Winner | icehockey\_nhl\_championship\_winner | 2021-11-07T09:55:00Z |\ | Ice Hockey | Finnish Liiga | icehockey\_liiga | 2025-02-10T06:30:38Z |\ | Ice Hockey | Finnish Mestis | icehockey\_mestis | 2025-02-10T06:30:38Z |\ | Ice Hockey | SHL | icehockey\_sweden\_hockey\_league | 2021-11-06T00:25:00Z |\ | Ice Hockey | HockeyAllsvenskan | icehockey\_sweden\_allsvenskan | 2021-11-06T00:25:00Z |\ | Lacrosse | Premier Lacrosse League | lacrosse\_pll | 2024-05-27T12:10:38Z |\ | Lacrosse | NCAA Lacrosse | lacrosse\_ncaa | 2025-02-01T04:40:38Z |\ | Mixed Martial Arts | MMA | mma\_mixed\_martial\_arts | 2020-06-06T10:05:00Z |\ | Politics | US Presidential Elections Winner | politics\_us\_presidential\_election\_winner | 2020-06-06T10:05:00Z |\ | Rugby League | NRL | rugbyleague\_nrl | 2020-06-06T10:05:00Z |\ | Rugby League | NRL State of Origin | rugbyleague\_nrl\_state\_of\_origin | 2025-05-19T03:00:37Z |\ | Rugby Union | Six Nations | rugbyunion\_six\_nations | 2025-01-31T05:45:38Z |\ | Soccer | Africa Cup of Nations | soccer\_africa\_cup\_of\_nations | 2022-01-14T07:05:00Z |\ | Soccer | Primera División - Argentina | soccer\_argentina\_primera\_division | 2020-10-30T15:15:00Z |\ | Soccer | A-League | soccer\_australia\_aleague | 2020-06-24T13:05:00Z |\ | Soccer | Austrian Football Bundesliga | soccer\_austria\_bundesliga | 2023-02-10T23:45:38Z |\ | Soccer | Belgium First Div | soccer\_belgium\_first\_div | 2020-07-24T00:05:00Z |\ | Soccer | Brazil Série A | soccer\_brazil\_campeonato | 2020-07-28T22:15:00Z |\ | Soccer | Brazil Série B | soccer\_brazil\_serie\_b | 2022-06-30T01:05:00Z |\ | Soccer | Primera División - Chile | soccer\_chile\_campeonato | 2022-06-30T01:05:00Z |\ | Soccer | Super League - China | soccer\_china\_superleague | 2020-07-15T22:15:00Z |\ | Soccer | Denmark Superliga | soccer\_denmark\_superliga | 2020-06-06T10:05:00Z |\ | Soccer | Championship | soccer\_efl\_champ | 2020-06-08T13:15:00Z |\ | Soccer | EFL Cup | soccer\_england\_efl\_cup | 2021-11-06T00:25:00Z |\ | Soccer | League 1 | soccer\_england\_league1 | 2020-06-12T15:25:00Z |\ | Soccer | League 2 | soccer\_england\_league2 | 2020-06-09T15:15:00Z |\ | Soccer | EPL | soccer\_epl | 2020-06-06T10:05:00Z |\ | Soccer | FA Cup | soccer\_fa\_cup | 2020-06-06T10:05:00Z |\ | Soccer | FIFA World Cup | soccer\_fifa\_world\_cup | 2022-04-03T00:45:00Z |\ | Soccer | FIFA World Cup Qualifiers - Europe | soccer\_fifa\_world\_cup\_qualifiers\_europe | 2025-03-24T08:25:38Z |\ | Soccer | FIFA World Cup Qualifiers - South America | soccer\_fifa\_world\_cup\_qualifiers\_south\_america | 2025-03-24T07:30:38Z |\ | Soccer | FIFA Women's World Cup | soccer\_fifa\_world\_cup\_womens | 2023-06-07T06:45:38Z |\ | Soccer | FIFA World Cup Winner | soccer\_fifa\_world\_cup\_winner | 2022-03-29T23:35:00Z |\ | Soccer | FIFA Club World Cup | soccer\_fifa\_club\_world\_cup | 2025-05-27T03:35:37Z |\ | Soccer | Veikkausliiga - Finland | soccer\_finland\_veikkausliiga | 2020-06-18T22:15:00Z |\ | Soccer | Ligue 1 - France | soccer\_france\_ligue\_one | 2020-07-16T00:55:00Z |\ | Soccer | Ligue 2 - France | soccer\_france\_ligue\_two | 2020-07-16T01:45:00Z |\ | Soccer | Bundesliga - Germany | soccer\_germany\_bundesliga | 2020-06-06T10:05:00Z |\ | Soccer | Bundesliga 2 - Germany | soccer\_germany\_bundesliga2 | 2020-06-06T10:05:00Z |\ | Soccer | 3\. Liga - Germany | soccer\_germany\_liga3 | 2023-02-10T23:40:38Z |\ | Soccer | Super League - Greece | soccer\_greece\_super\_league | 2023-02-10T23:55:38Z |\ | Soccer | Serie A - Italy | soccer\_italy\_serie\_a | 2020-06-06T10:05:00Z |\ | Soccer | Serie B - Italy | soccer\_italy\_serie\_b | 2020-06-10T14:25:00Z |\ | Soccer | J League | soccer\_japan\_j\_league | 2020-06-23T00:25:00Z |\ | Soccer | K League 1 | soccer\_korea\_kleague1 | 2020-06-06T10:05:00Z |\ | Soccer | League of Ireland | soccer\_league\_of\_ireland | 2020-07-29T08:45:00Z |\ | Soccer | Liga MX | soccer\_mexico\_ligamx | 2020-07-15T17:25:00Z |\ | Soccer | Dutch Eredivisie | soccer\_netherlands\_eredivisie | 2020-09-04T16:15:00Z |\ | Soccer | Eliteserien - Norway | soccer\_norway\_eliteserien | 2020-06-06T10:05:00Z |\ | Soccer | Ekstraklasa - Poland | soccer\_poland\_ekstraklasa | 2022-06-30T01:05:00Z |\ | Soccer | Primeira Liga - Portugal | soccer\_portugal\_primeira\_liga | 2020-06-06T10:05:00Z |\ | Soccer | Premier League - Russia | soccer\_russia\_premier\_league | 2025-12-01T00:40:37Z |\ | Soccer | La Liga - Spain | soccer\_spain\_la\_liga | 2020-06-06T10:05:00Z |\ | Soccer | La Liga 2 - Spain | soccer\_spain\_segunda\_division | 2020-06-06T10:05:00Z |\ | Soccer | Premiership - Scotland | soccer\_spl | 2020-07-17T13:55:00Z |\ | Soccer | Allsvenskan - Sweden | soccer\_sweden\_allsvenskan | 2020-06-06T10:05:00Z |\ | Soccer | Superettan - Sweden | soccer\_sweden\_superettan | 2020-06-06T10:05:00Z |\ | Soccer | Swiss Superleague | soccer\_switzerland\_superleague | 2020-06-06T10:05:00Z |\ | Soccer | Turkey Super League | soccer\_turkey\_super\_league | 2020-06-06T10:05:00Z |\ | Soccer | UEFA Europa Conference League | soccer\_uefa\_europa\_conference\_league | 2022-10-23T01:50:38Z |\ | Soccer | UEFA Champions League | soccer\_uefa\_champs\_league | 2020-07-10T16:15:00Z |\ | Soccer | UEFA Champions League Qualification | soccer\_uefa\_champs\_league\_qualification | 2023-07-22T06:50:40Z |\ | Soccer | UEFA Women's Champions League | soccer\_uefa\_champs\_league\_women | 2025-03-24T07:45:38Z |\ | Soccer | UEFA Europa League | soccer\_uefa\_europa\_league | 2020-06-22T18:25:00Z |\ | Soccer | UEFA Euro 2024 | soccer\_uefa\_european\_championship | 2021-05-19T05:25:00Z |\ | Soccer | UEFA Euro Qualification | soccer\_uefa\_euro\_qualification | 2023-10-12T12:40:40Z |\ | Soccer | UEFA Nations League | soccer\_uefa\_nations\_league | 2022-06-11T00:25:00Z |\ | Soccer | CONCACAF Gold Cup | soccer\_concacaf\_gold\_cup | 2025-06-09T07:10:37Z |\ | Soccer | CONCACAF Leagues Cup | soccer\_concacaf\_leagues\_cup | 2025-07-25T11:45:38Z |\ | Soccer | Copa América | soccer\_conmebol\_copa\_america | 2024-04-10T03:05:38Z |\ | Soccer | Copa Libertadores | soccer\_conmebol\_copa\_libertadores | 2022-06-11T00:45:00Z |\ | Soccer | Copa Sudamericana | soccer\_conmebol\_copa\_sudamericana | 2025-03-24T07:30:38Z |\ | Soccer | MLS | soccer\_usa\_mls | 2020-06-27T03:05:00Z |\ | Tennis | ATP Australian Open | tennis\_atp\_aus\_open\_singles | 2021-02-06T11:45:00Z |\ | Tennis | ATP Canadian Open | tennis\_atp\_canadian\_open | 2024-08-06T04:10:38Z |\ | Tennis | ATP China Open | tennis\_atp\_china\_open | 2024-09-24T19:25:39Z |\ | Tennis | ATP Cincinnati Open | tennis\_atp\_cincinnati\_open | 2024-08-12T01:50:38Z |\ | Tennis | ATP Dubai Championships | tennis\_atp\_dubai | 2025-02-24T01:15:38Z |\ | Tennis | ATP French Open | tennis\_atp\_french\_open | 2020-09-24T22:55:00Z |\ | Tennis | ATP Indian Wells | tennis\_atp\_indian\_wells | 2025-03-04T22:20:40Z |\ | Tennis | ATP Italian Open | tennis\_atp\_italian\_open | 2025-05-06T10:45:38Z |\ | Tennis | ATP Madrid Open | tennis\_atp\_madrid\_open | 2025-04-22T05:55:38Z |\ | Tennis | ATP Miami Open | tennis\_atp\_miami\_open | 2025-03-17T21:55:38Z |\ | Tennis | ATP Monte-Carlo Masters | tennis\_atp\_monte\_carlo\_masters | 2025-04-06T09:30:38Z |\ | Tennis | ATP Paris Masters | tennis\_atp\_paris\_masters | 2024-10-28T04:10:37Z |\ | Tennis | ATP Qatar Open | tennis\_atp\_qatar\_open | 2025-02-16T10:00:38Z |\ | Tennis | ATP Shanghai Masters | tennis\_atp\_shanghai\_masters | 2024-10-05T03:55:38Z |\ | Tennis | ATP US Open | tennis\_atp\_us\_open | 2020-08-28T10:05:00Z |\ | Tennis | ATP Wimbledon | tennis\_atp\_wimbledon | 2021-06-25T22:35:00Z |\ | Tennis | WTA Australian Open | tennis\_wta\_aus\_open\_singles | 2021-02-06T11:45:00Z |\ | Tennis | WTA Canadian Open | tennis\_wta\_canadian\_open | 2024-08-06T04:10:38Z |\ | Tennis | WTA China Open | tennis\_wta\_china\_open | 2024-09-24T05:00:38Z |\ | Tennis | WTA Cincinnati Open | tennis\_wta\_cincinnati\_open | 2024-08-12T01:50:38Z |\ | Tennis | WTA Dubai Championships | tennis\_wta\_dubai | 2025-02-16T10:25:38Z |\ | Tennis | WTA French Open | tennis\_wta\_french\_open | 2020-09-24T22:55:00Z |\ | Tennis | WTA Indian Wells | tennis\_wta\_indian\_wells | 2025-03-04T23:30:39Z |\ | Tennis | WTA Italian Open | tennis\_wta\_italian\_open | 2025-05-06T10:45:38Z |\ | Tennis | WTA Madrid Open | tennis\_wta\_madrid\_open | 2025-04-22T05:55:38Z |\ | Tennis | WTA Miami Open | tennis\_wta\_miami\_open | 2025-03-17T21:45:37Z |\ | Tennis | WTA Qatar Open | tennis\_wta\_qatar\_open | 2025-02-10T05:10:37Z |\ | Tennis | WTA US Open | tennis\_wta\_us\_open | 2020-08-28T10:05:00Z |\ | Tennis | WTA Wimbledon | tennis\_wta\_wimbledon | 2021-06-25T22:45:00Z |\ | Tennis | WTA Wuhan Open | tennis\_wta\_wuhan\_open | 2024-10-06T13:00:37Z |\ \ [#](https://the-odds-api.com/historical-odds-data/#get-access)\ Get Access\ --------------------------------------------------------------------------\ \ Historical odds data is only available for paid subscriptions. Get an API key by subscribing to a [usage plan](https://the-odds-api.com/#get-access)\ .\ \ Subscriptions can also be managed in the [accounts portal](https://the-odds-api.com/account/)\ . --- # Odds API Code Samples V4 | The Odds API [#](https://the-odds-api.com/liveapi/guides/v4/samples.html#code-samples-v4) Code Samples V4 ============================================================================================= The Odds API is easy to use with your favorite coding language. We've included simple Python and Node.js code examples to help you get started. Be sure to specify your api key in order for the examples to work. Get a [free API key here](https://the-odds-api.com/#get-access) . For more details, see the [API docs](https://the-odds-api.com/liveapi/guides/v4/index.html) . Code samples are also available on [Github (opens new window)](https://github.com/the-odds-api) [#](https://the-odds-api.com/liveapi/guides/v4/samples.html#python) Python --------------------------------------------------------------------------- Note This example uses python's [requests library (opens new window)](http://docs.python-requests.org/en/master/) , which can be installed with `pip install requests` Security Tip for Repl.it users This example uses [Repl.it (opens new window)](https://repl.it/) \* to run live code. If you continue coding using a free Repl.it account, anyone visiting your Repl.it repo might see your api key. To make sure it stays secret, create a file called `.env` containing `api_key=YOUR_API_KEY` Back in main.py, bring in your api key with: import os api_key = os.getenv("api_key") For more info, see the [Repl.it docs (opens new window)](https://repl.it/site/docs/repls/secret-keys) \* The Odds API is not affiliated with Repl.it in any way This code sample can also be found on [Github (opens new window)](https://github.com/the-odds-api/samples-python) [#](https://the-odds-api.com/liveapi/guides/v4/samples.html#node-js) Node.js ----------------------------------------------------------------------------- Note This example uses Node's [axios library (opens new window)](https://www.npmjs.com/package/axios) , which can be installed with `npm install axios` or `bower install axios` Security Tip for Repl.it users This example uses [Repl.it (opens new window)](https://repl.it/) \* to run live code. If you continue coding using a free Repl.it account, anyone visiting your Repl.it repo might see your api key. To make sure it stays secret, create a file called `.env` containing `api_key=YOUR_API_KEY` Back in index.js, bring in your api key with: const api_key = process.env.api_key For more info, see the [Repl.it docs (opens new window)](https://repl.it/site/docs/repls/secret-keys) \* The Odds API is not affiliated with Repl.it in any way This code sample can also be found on [Github (opens new window)](https://github.com/the-odds-api/samples-nodejs) --- # Odds API Docs V3 | The Odds API [#](https://the-odds-api.com/liveapi/guides/v3/#page-frontmatter-title) Odds API Docs V3 ========================================================================================= Update Version 4 of the API is now available. Docs for version 4 can be [found here](https://the-odds-api.com/liveapi/guides/v4/) Version 3 will continue to be maintained. Version 4 currently offers the same data, however in a format that's more convenient for new implementations. [#](https://the-odds-api.com/liveapi/guides/v3/#overview) Overview ------------------------------------------------------------------- Get started with The Odds API in **3 steps** **Step 1** Get an API key via email See plans **Step 2** Get a list of in-season sports [Details](https://the-odds-api.com/liveapi/guides/v3/#get-sports) **GET** [/v3/sports?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v3/sports?apiKey=YOUR_API_KEY) { "key": "soccer_epl", "active": true, "group": "Soccer - UK", "details": "English Premier League 🇬🇧", "title": "EPL" }, ... **Step 3** Use the sport **key** from step 2 to get a list of upcoming events and odds from different bookmakers [Details](https://the-odds-api.com/liveapi/guides/v3/#get-odds) **GET** [/v3/odds?sport=soccer\_epl®ion=uk&apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v3/odds/?sport=soccer_epl®ion=uk&apiKey=YOUR_API_KEY) { "sport_key": "soccer_epl", "sport_nice": "EPL", "teams": ["Chelsea", "Manchester United"], "commence_time": 1540035000, "home_team": "Chelsea", "sites": [\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": 1540020857,\ "odds": {\ "h2h": [\ 1.68,\ 5.5,\ 4.05\ ]\ }\ },\ ...\ \ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v3/#host)\ Host\ -----------------------------------------------------------\ \ All requests use the host `https://api.the-odds-api.com`\ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v3/#get-sports)\ GET sports\ -----------------------------------------------------------------------\ \ Returns a list of in-season sport objects. The sport key can be used as the `sport` parameter in the /odds requests (below). This endpoint does not cost usage credits.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#endpoint)\ Endpoint\ \ \ \ **GET** /v3/sports/?apiKey={apiKey}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#parameters)\ Parameters\ \ * **apiKey**   The API key associated with your subscription. [See here for usage plans](https://the-odds-api.com/#get-access)\ \ * **all**   Optional - if this parameter is present (for example, `all=true`), a list of all sports (in and out of season) will be returned\ \ * **outrights**   Optional - if this parameter is present (for example, `outrights=true`), the response will include sports and events with outright markets (for example, Super Bowl Winner). [See more info on outrights](https://the-odds-api.com/releases/outrights.html)\ \ \ \ \ Try it out in the browser\ \ [https://api.the-odds-api.com/v3/sports/?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v3/sports/?apiKey=YOUR_API_KEY)\ \ Viewing JSON in the browser is easier with a prettifier such as [JSON Viewer (opens new window)](https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh)\ for Chrome\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#example-request)\ Example Request\ \ \ \ **GET** [https://api.the-odds-api.com/v3/sports/?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v3/sports/?apiKey=YOUR_API_KEY)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#example-response)\ Example Response\ \ \ \ {\ "success": true,\ "data": [\ {\ "key": "americanfootball_ncaaf",\ "active": true,\ "group": "American Football",\ "details": "US College Football",\ "title": "NCAAF"\ },\ {\ "key": "americanfootball_nfl",\ "active": true,\ "group": "American Football",\ "details": "US Football",\ "title": "NFL"\ },\ {\ "key": "aussierules_afl",\ "active": true,\ "group": "Aussie Rules",\ "details": "Aussie Football",\ "title": "AFL"\ },\ {\ "key": "baseball_mlb",\ "active": true,\ "details": "Major League Baseball 🇺🇸",\ "group": "Baseball",\ "title": "MLB"\ },\ {\ "key": "cricket_test_match",\ "active": true,\ "details": "International Test Matches",\ "group": "Cricket",\ "title": "Test Matches"\ },\ {\ "key": "mma_mixed_martial_arts",\ "active": true,\ "group": "Mixed Martial Arts",\ "details": "Mixed Martial Arts",\ "title": "MMA"\ },\ {\ "key": "rugbyleague_nrl",\ "active": true,\ "group": "Rugby League",\ "details": "Aussie Rugby League",\ "title": "NRL"\ },\ {\ "key": "soccer_belgium_first_div",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Belgium Soccer 🇧🇪",\ "title": "Belgium First Div"\ },\ {\ "key": "soccer_china_superleague",\ "active": true,\ "details": "Chinese Soccer 🇨🇳",\ "group": "Soccer - Other",\ "title": "Super League - China"\ },\ {\ "key": "soccer_denmark_superliga",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Danish Soccer 🇩🇰",\ "title": "Denmark Superliga"\ },\ {\ "key": "soccer_efl_champ",\ "active": true,\ "group": "Soccer - UK",\ "details": "EFL Championship 🇬🇧",\ "title": "Championship"\ },\ {\ "key": "soccer_england_league1",\ "active": true,\ "group": "Soccer - UK",\ "details": "EFL League 1 🇬🇧",\ "title": "League 1"\ },\ {\ "key": "soccer_england_league2",\ "active": true,\ "group": "Soccer - UK",\ "details": "EFL League 2 🇬🇧",\ "title": "League 2"\ },\ {\ "key": "soccer_epl",\ "active": true,\ "group": "Soccer - UK",\ "details": "English Premier League 🇬🇧",\ "title": "EPL"\ },\ {\ "key": "soccer_finland_veikkausliiga",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Finnish Soccer 🇫🇮",\ "title": "Veikkausliiga - Finland"\ },\ {\ "key": "soccer_france_ligue_one",\ "active": true,\ "group": "Soccer - Europe",\ "details": "French Soccer 🇫🇷",\ "title": "Ligue 1 - France"\ },\ {\ "key": "soccer_france_ligue_two",\ "active": true,\ "details": "French Soccer 🇫🇷",\ "group": "Soccer - Europe",\ "title": "Ligue 2 - France"\ },\ {\ "key": "soccer_germany_bundesliga",\ "active": true,\ "group": "Soccer - Europe",\ "details": "German Soccer 🇩🇪",\ "title": "Bundesliga - Germany"\ },\ {\ "key": "soccer_germany_bundesliga2",\ "active": true,\ "details": "German Soccer 🇩🇪",\ "group": "Soccer - Europe",\ "title": "Bundesliga 2 - Germany"\ },\ {\ "key": "soccer_mexico_ligamx",\ "active": true,\ "details": "Mexican Soccer 🇲🇽",\ "group": "Soccer - Other",\ "title": "Liga MX"\ },\ {\ "key": "soccer_netherlands_eredivisie",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Dutch Soccer 🇳🇱",\ "title": "Dutch Eredivisie"\ },\ {\ "key": "soccer_norway_eliteserien",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Norwegian Soccer 🇳🇴",\ "title": "Eliteserien - Norway"\ },\ {\ "key": "soccer_portugal_primeira_liga",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Portugese Soccer 🇵🇹",\ "title": "Primeira Liga - Portugal"\ },\ {\ "key": "soccer_russia_premier_league",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Russian Soccer 🇷🇺",\ "title": "Premier League - Russia"\ },\ {\ "key": "soccer_spain_la_liga",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Spanish Soccer 🇪🇸",\ "title": "La Liga - Spain"\ },\ {\ "key": "soccer_spl",\ "active": true,\ "group": "Soccer - UK",\ "details": "Scottish Premier League 🇬🇧",\ "title": "SPL"\ },\ {\ "key": "soccer_sweden_allsvenskan",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Swedish Soccer 🇸🇪",\ "title": "Allsvenskan - Sweden"\ },\ {\ "key": "soccer_sweden_superettan",\ "active": true,\ "details": "Swedish Soccer 🇸🇪",\ "group": "Soccer - Europe",\ "title": "Superettan - Sweden"\ },\ {\ "key": "soccer_switzerland_superleague",\ "active": true,\ "group": "Soccer - Europe",\ "details": "Swiss Soccer 🇨🇭",\ "title": "Super League - Swiss"\ },\ {\ "key": "soccer_usa_mls",\ "active": true,\ "group": "Soccer - Other",\ "details": "Major League Soccer 🇺🇸",\ "title": "MLS"\ }\ ]\ }\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#response-headers)\ Response Headers\ \ Calls to the /sports method will not affect the quota usage. The following response headers are returned:\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits since the last quota reset\ \ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v3/#get-odds)\ GET odds\ -------------------------------------------------------------------\ \ Returns a list of upcoming and live games with recent odds for a given sport, region and market\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#endpoint-2)\ Endpoint\ \ \ \ **GET** /v3/odds/?apiKey={apiKey}&sport={sport}®ion={region}&mkt={mkt}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#parameters-2)\ Parameters\ \ * **apiKey**   The API key associated with your subscription. [See here for usage plans](https://the-odds-api.com/#get-access)\ \ * **sport**   The sport key obtained from calling the /sports method. `upcoming` is always valid, returning any live games as well as the next 8 upcoming games across all sports\ \ * **region**   Determines which bookmakers are returned. Valid regions are `au` (Australia), `uk` (United Kingdom), `eu` (Europe) and `us` (United States)\ \ * **mkt**   Optional - Determines which odds market is returned. Defaults to `h2h` (head to head / moneyline). Valid markets are `h2h`, `spreads` (handicaps) and `totals` (over/under).\ \ Lay odds are automatically included with `h2h` results for relevant bookmakers (Betfair, Matchbook etc). These appear in the results under the `h2h_lay` key.\ \ From July 2020, `outrights` are a valid market for sports with `has_outrights: true`. If the sport has outrights, set `mkt=outrights`. Lay odds for outrights (`outrights_lay`) will automatically be available for relevant exchanges. [More info on outrights](https://the-odds-api.com/releases/outrights.html)\ \ * **dateFormat**   Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `unix`.\ \ * **oddsFormat**   Optional - Determines the format of odds in the response. Valid values are `decimal` and `american`. Defaults to `decimal`. When set to `american`, small discrepancies might exist for some bookmakers due to rounding errors.\ \ \ \ \ Try it out in the browser\ \ [https://api.the-odds-api.com/v3/odds/?sport=upcoming®ion=... (opens new window)](https://api.the-odds-api.com/v3/odds/?sport=upcoming®ion=uk&mkt=h2h&apiKey=YOUR_API_KEY)\ \ Viewing JSON in the browser is easier with a prettifier such as [JSON Viewer (opens new window)](https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh)\ for Chrome\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#example-request-2)\ Example Request\ \ \ \ **GET** [https://api.the-odds-api.com/v3/odds/?apiKey=YOUR\_API\_KEY&sport=soccer\_epl®ion=uk&mkt=h2h (opens new window)](https://api.the-odds-api.com/v3/odds/?apiKey=YOUR_API_KEY&sport=soccer_epl®ion=uk&mkt=h2h)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#example-response-2)\ Example Response\ \ \ \ {\ "success": true,\ "data": [\ {\ "id": "5cc7c4e08fb03088252f8e0b046bb761",\ "sport_key": "soccer_epl",\ "sport_nice": "EPL",\ "teams": ["Bournemouth", "Everton"],\ "commence_time": 1535205600,\ "home_team": "Bournemouth",\ "sites": [\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": 1535157373,\ "odds": { "h2h": [2.65, 2.7, 3.6] }\ },\ {\ "site_key": "betvictor",\ "site_nice": "Bet Victor",\ "last_update": 1535157374,\ "odds": { "h2h": [2.55, 2.8, 3.6] }\ },\ {\ "site_key": "ladbrokes",\ "site_nice": "Ladbrokes",\ "last_update": 1535157143,\ "odds": { "h2h": [2.5, 2.65, 3.5] }\ },\ {\ "site_key": "betfair",\ "site_nice": "Betfair",\ "last_update": 1535157209,\ "odds": { "h2h": [2.68, 2.8, 3.65] }\ },\ {\ "site_key": "skybet",\ "site_nice": "Sky Bet",\ "last_update": 1535157054,\ "odds": { "h2h": [2.4, 2.63, 3.6] }\ },\ {\ "site_key": "paddypower",\ "site_nice": "Paddy Power",\ "last_update": 1535157357,\ "odds": { "h2h": [2.6, 2.7, 3.5] }\ }\ ],\ "sites_count": 6\ },\ {\ "id": "d689bc4a1d0fe53463e500059280057e",\ "sport_key": "soccer_epl",\ "sport_nice": "EPL",\ "teams": ["Arsenal", "West Ham United"],\ "commence_time": 1535205600,\ "home_team": "Arsenal",\ "sites": [\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": 1535157373,\ "odds": { "h2h": [1.38, 8.75, 5.5] }\ },\ {\ "site_key": "betvictor",\ "site_nice": "Bet Victor",\ "last_update": 1535157374,\ "odds": { "h2h": [1.36, 8.5, 5.5] }\ },\ {\ "site_key": "ladbrokes",\ "site_nice": "Ladbrokes",\ "last_update": 1535157143,\ "odds": { "h2h": [1.36, 8, 5] }\ },\ {\ "site_key": "betfair",\ "site_nice": "Betfair",\ "last_update": 1535157209,\ "odds": { "h2h": [1.39, 9.4, 5.6] }\ },\ {\ "site_key": "skybet",\ "site_nice": "Sky Bet",\ "last_update": 1535157054,\ "odds": { "h2h": [1.36, 7.5, 5] }\ },\ {\ "site_key": "paddypower",\ "site_nice": "Paddy Power",\ "last_update": 1535157357,\ "odds": { "h2h": [1.33, 8.5, 5.5] }\ }\ ],\ "sites_count": 6\ },\ {\ "id": "c66e5a4cfe4e2571734021d8340a02c2",\ "sport_key": "soccer_epl",\ "sport_nice": "EPL",\ "teams": ["Huddersfield Town", "Cardiff City"],\ "commence_time": 1535205600,\ "home_team": "Huddersfield Town",\ "sites": [\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": 1535157373,\ "odds": { "h2h": [2.4, 3.65, 3] }\ },\ {\ "site_key": "betvictor",\ "site_nice": "Bet Victor",\ "last_update": 1535157374,\ "odds": { "h2h": [2.4, 3.6, 3] }\ },\ {\ "site_key": "ladbrokes",\ "site_nice": "Ladbrokes",\ "last_update": 1535157143,\ "odds": { "h2h": [2.3, 3.4, 2.9] }\ },\ {\ "site_key": "betfair",\ "site_nice": "Betfair",\ "last_update": 1535157209,\ "odds": { "h2h": [2.46, 3.7, 3.05] }\ },\ {\ "site_key": "skybet",\ "site_nice": "Sky Bet",\ "last_update": 1535157054,\ "odds": { "h2h": [2.38, 3.4, 2.9] }\ },\ {\ "site_key": "paddypower",\ "site_nice": "Paddy Power",\ "last_update": 1535157357,\ "odds": { "h2h": [2.3, 3.5, 2.88] }\ }\ ],\ "sites_count": 6\ },\ {\ "id": "d676957e3a4a2d652c7c4237869f7c0b",\ "sport_key": "soccer_epl",\ "sport_nice": "EPL",\ "teams": ["Southampton", "Leicester City"],\ "commence_time": 1535205600,\ "home_team": "Southampton",\ "sites": [\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": 1535157373,\ "odds": { "h2h": [2.45, 3.2, 3.3] }\ },\ {\ "site_key": "betvictor",\ "site_nice": "Bet Victor",\ "last_update": 1535157374,\ "odds": { "h2h": [2.4, 3.3, 3.25] }\ },\ {\ "site_key": "ladbrokes",\ "site_nice": "Ladbrokes",\ "last_update": 1535157143,\ "odds": { "h2h": [2.35, 3.2, 3.1] }\ },\ {\ "site_key": "skybet",\ "site_nice": "Sky Bet",\ "last_update": 1535157054,\ "odds": { "h2h": [2.3, 3.2, 3.2] }\ },\ {\ "site_key": "paddypower",\ "site_nice": "Paddy Power",\ "last_update": 1535157357,\ "odds": { "h2h": [2.4, 3.1, 3.2] }\ },\ {\ "site_key": "betfair",\ "site_nice": "Betfair",\ "last_update": 1535157209,\ "odds": { "h2h": [2.44, 3.3, 3.4] }\ }\ ],\ "sites_count": 6\ }\ ]\ }\ \ \ \ \ **Notes**\ \ * Head to head (moneyline) odds are in the same order as teams. For 3 outcome sports, the 3rd item in the h2h list is the draw odd.\ \ **Example** For the first event in the above response, the odds for Unibet are Bournemouth: 2.65, Everton: 2.7, Draw: 3.6\ \ * `id` is a unique game id. For details on how this is constructed, see the [release notes](https://the-odds-api.com/releases/game-id.html)\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v3/#response-headers-2)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ \ \ \ Occasionally a bookmaker might disappear from the API response. This can happen for a number of reasons, for example, their site might be down for maintenance or they may have changed their site. These situations are often short-lived.\ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v3/#code-samples)\ Code Samples\ ---------------------------------------------------------------------------\ \ Get started right away with [code samples for Python and NodeJs](https://the-odds-api.com/liveapi/guides/v3/samples.html)\ . Code samples are also available on [Github (opens new window)](https://github.com/the-odds-api)\ \ [#](https://the-odds-api.com/liveapi/guides/v3/#more-info)\ More Info\ ---------------------------------------------------------------------\ \ Odds may be unavailable if the sport is not in season. Odds may temporarily become unavailable if bookmakers stop listing games in between rounds. If no odds are returned, the request will not count against the usage quota.\ \ We continually add sports, bookmakers and features. Stay up to date by [following us on Twitter (opens new window)](https://twitter.com/The_Odds_API) --- # Sports Odds API | The Odds API Sports betting API covering odds from bookmakers around the world [API Docs](https://the-odds-api.com/liveapi/guides/v4/)     •     [Code Samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) Get API Key → Not a developer? See the add-ons for [Excel](https://the-odds-api.com/features/excel.html) and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) { "id": "bda33adca828c09dc3cac3a856aef176", "sport_key": "americanfootball_nfl", "commence_time": "2021-09-10T00:20:00Z", "home_team": "Tampa Bay Buccaneers", "away_team": "Dallas Cowboys", "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2021-06-10T10:46:09Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ { "name": "Dallas Cowboys", "price": 240 },\ { "name": "Tampa Bay Buccaneers", "price": -303 }\ ]\ ...\ \ [#](https://the-odds-api.com/#get-access)\ Get Access\ -----------------------------------------------------\ \ Subscribe to receive your API key via email\ \ Starter\ \ FREE\ \  \ \ 500 credits \ per month\ \ All sports\ \ Most bookmakers\ \ All betting markets\ \ ~Historical Odds~\ \ START\ \ 20K\ \ $30\ \ per month, USD\ \ 20,000 credits \ per month\ \ All sports\ \ All bookmakers\ \ All betting markets\ \ Historical Odds\ \ START\ \ 100K\ \ $59\ \ per month, USD\ \ 100,000 credits \ per month\ \ All sports\ \ All bookmakers\ \ All betting markets\ \ Historical Odds\ \ START\ \ 5M\ \ $119\ \ per month, USD\ \ 5M credits \ per month\ \ All sports\ \ All bookmakers\ \ All betting markets\ \ Historical Odds\ \ START\ \ 15M\ \ $249\ \ per month, USD\ \ 15M credits \ per month\ \ All sports\ \ All bookmakers\ \ All betting markets\ \ Historical Odds\ \ START\ \ [Create an account](https://the-odds-api.com/account/)\ to discover higher usage plans\ \ Features\ --------\ \ Bookmakers\ \ The Odds API covers odds from several global bookmakers including\ \ * **US Bookmakers** \ DraftKings, FanDuel, BetMGM, Caesars, Bovada, MyBookie.ag and more\ * **UK Bookmakers** \ Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more\ * **EU Bookmakers** \ 1xBet, Pinnacle, Betfair, Unibet and more\ * **Aussie Bookmakers** \ Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more\ \ See the [full list of bookmakers →](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ Sports\ \ The Odds API provides odds data for several in-season sports\ \ * **Football odds data**   NFL, College Football (NCAA), CFL, Aussie Rules (AFL)\ * **Soccer odds data**   EPL, EFL Championship, German Bundesliga, UEFA Europa & Champions Leagues, Italian Serie A, Spanish La Liga, Campeonato Brasileiro Série A, French Ligue 1 and much more\ * **Basketball odds data**   NBA, US College Basketball (NCAA), WNBA, Euroleague\ * **Baseball odds data**   MLB, MiLB, KBO, NPB\ * **Ice hockey odds data**   NHL, AHL, SHL, HockeyAllsvenskan, Liiga, Mestis\ * **Cricket odds data**   Test matches, IPL, Big Bash and more\ * **Rugby league odds data**   Aussie NRL\ * **Golf odds data**   Masters Tournament, PGA Championship, US Open, The Open Championship\ * **Tennis odds data**   All Grand Slams and more\ * **Politics odds data**   Next US President odds\ * **And more**\ \ See the [full list of sports →](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ \ Betting Markets\ \ The Odds API offers odds data for the following betting markets\ \ * **head-to-head (moneyline) odds**\ * **point spreads (handicap) odds**\ * **totals (over/under) odds**\ * **outrights (futures) odds** for selected competitions\ * **And more** Player props, alternate spreads and totals, and other markets are now available for selected sports and bookmakers, with more on the way\ \ [More info on betting markets →](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ \ Update Intervals\ \ The Odds API delivers recent odds for in-play and upcoming sports events from several bookmakers.\ \ [More info on update intervals →](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ \ Format\ \ The Odds API feed is in JSON format, and is also available as add-ons for [Google Sheets](https://the-odds-api.com/features/spreadsheets.html)\ and [Excel](https://the-odds-api.com/features/excel.html)\ \ The Odds API feed supports decimal and American odds formats.\ \ Why The Odds API\ ----------------\ \ Easy Integration\ \ The Odds API is simple & well-documented, allowing for fast, low-cost integration\ \ Coverage & Features\ \ We cover over 70 sports and over 40 bookmakers, and we continue to expand our offering\ \ Here for the long run\ \ We've been operating since 2017, based out of Melbourne, Australia\ \ FAQs\ ----\ \ Q What happens when I subscribe?\ \ You will receive an email containing your API key and links to help you get started.\ \ Q When am I billed?\ \ For paid plans, billing happens straight away. Payment then happens automatically each month thereafter, on the same day of the month that the subscription started. \ \ For example if the first payment happens on the 1st of the month, you will be charged on the 1st for subsequent months.\ \ Q How can I cancel?\ \ You can cancel your subscription at any time using [this form](https://the-odds-api.com/manage/cancel.html)\ or in the [accounts portal](https://the-odds-api.com/account/)\ . \ \ Your subscription will automatically cancel before the next billing cycle.\ \ Q What is a request?\ \ A single request returns live and upcoming games for a given **sport**, betting **market**, and bookmaker **region**. Each game includes a start time, participants, and bookmaker odds for the specified region. \ \ **Example**: if you request odds for basketball NBA, from US-region bookmakers, and moneyline betting markets, the API will return live and upcoming NBA games, showing moneyline odds from US bookmakers. This will count as 1 request from your plan's usage quota.\ \ Q How frequently are odds updated?\ \ More info on odds update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [More FAQs →](https://the-odds-api.com/manage/faqs.html)\ \ More from The Odds API\ ----------------------\ \ * [**Historical Sports Odds API**](https://the-odds-api.com/historical-odds-data/)\ Historical snapshots of sports odds data back to 2020.\ * [**Scores & Results API**](https://the-odds-api.com/liveapi/guides/v4/#get-scores)\ Game scores and results in a simple API.\ * [**Odds Widget for Websites**](https://the-odds-api.com/widget/)\ Bring bookmaker odds into your website with a simple HTML tag. Monetize with your own affiliate links.\ * **[Excel](https://the-odds-api.com/features/excel.html)\ and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html)\ Add-ons** Get odds data in spreadsheets at the click of a button.\ * **[Player Props Odds](https://the-odds-api.com/sports-odds-data/betting-markets.html#player-props-api-markets)\ ** Player props odds are now available in the API for selected US sports and bookmakers, with more on the way.\ \ Stay Updated\ ------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ \ to stay updated on new sports, bookmakers and features --- # Odds API Documentation V4 | The Odds API [#](https://the-odds-api.com/liveapi/guides/v4/#page-frontmatter-title) Odds API Documentation V4 ================================================================================================== [#](https://the-odds-api.com/liveapi/guides/v4/#overview) Overview ------------------------------------------------------------------- Get started with The Odds API in **3 steps** **Step 1** Get an API key via email See plans **Step 2** Get a list of in-season sports [Details](https://the-odds-api.com/liveapi/guides/v4/#get-sports) **GET** [/v4/sports?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports?apiKey=YOUR_API_KEY) { "key": "americanfootball_nfl", "group": "American Football", "title": "NFL", "description": "US Football", "active": true, "has_outrights": false }, ... **Step 3** Use the sport **key** from step 2 to get a list of upcoming events and odds from different bookmakers Use the `oddsFormat` parameter to show odds in either decimal or American format [Details](https://the-odds-api.com/liveapi/guides/v4/#get-odds) **GET** [/v4/sports/americanfootball\_nfl/odds?regions=us&oddsFormat=american&apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?regions=us&oddsFormat=american&apiKey=YOUR_API_KEY) { "id": "bda33adca828c09dc3cac3a856aef176", "sport_key": "americanfootball_nfl", "commence_time": "2021-09-10T00:20:00Z", "home_team": "Tampa Bay Buccaneers", "away_team": "Dallas Cowboys", "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2021-06-10T10:46:09Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys", \ "price": 240 \ },\ {\ "name": "Tampa Bay Buccaneers", \ "price": -303\ }\ ]\ ...\ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#host)\ Host\ -----------------------------------------------------------\ \ All requests use the host `https://api.the-odds-api.com`\ \ Connections that require IPv6 can use `https://ipv6-api.the-odds-api.com`\ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-sports)\ GET sports\ -----------------------------------------------------------------------\ \ Returns a list of in-season sport objects. The sport key can be used as the `sport` parameter in other endpoints. This endpoint does not count against the usage quota.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint)\ Endpoint\ \ **GET** /v4/sports/?apiKey={apiKey}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters)\ Parameters\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ * **all**   Optional - if this parameter is set to true (`all=true`), a list of both in and out of season sports will be returned\ \ \ \ \ Try it out in the browser\ \ [https://api.the-odds-api.com/v4/sports/?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports/?apiKey=YOUR_API_KEY)\ \ Viewing JSON in the browser is easier with a prettifier such as [JSON Viewer (opens new window)](https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh)\ for Chrome\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema)\ Schema\ \ For a detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/sports/get_v4_sports)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports/?apiKey=YOUR_API_KEY)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response)\ Example Response\ \ [\ {\ "key": "americanfootball_ncaaf",\ "group": "American Football",\ "title": "NCAAF",\ "description": "US College Football",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "americanfootball_nfl",\ "group": "American Football",\ "title": "NFL",\ "description": "US Football",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "americanfootball_nfl_super_bowl_winner",\ "group": "American Football",\ "title": "NFL Super Bowl Winner",\ "description": "Super Bowl Winner 2021/2022",\ "active": true,\ "has_outrights": true\ },\ {\ "key": "aussierules_afl",\ "group": "Aussie Rules",\ "title": "AFL",\ "description": "Aussie Football",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "baseball_mlb",\ "group": "Baseball",\ "title": "MLB",\ "description": "Major League Baseball",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "basketball_nba",\ "group": "Basketball",\ "title": "NBA",\ "description": "US Basketball",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "cricket_test_match",\ "group": "Cricket",\ "title": "Test Matches",\ "description": "International Test Matches",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "golf_masters_tournament_winner",\ "group": "Golf",\ "title": "Masters Tournament Winner",\ "description": "2022 WInner",\ "active": true,\ "has_outrights": true\ },\ {\ "key": "golf_the_open_championship_winner",\ "group": "Golf",\ "title": "The Open Winner",\ "description": "2021 WInner",\ "active": true,\ "has_outrights": true\ },\ {\ "key": "golf_us_open_winner",\ "group": "Golf",\ "title": "US Open Winner",\ "description": "2021 WInner",\ "active": true,\ "has_outrights": true\ },\ {\ "key": "icehockey_nhl",\ "group": "Ice Hockey",\ "title": "NHL",\ "description": "US Ice Hockey",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "mma_mixed_martial_arts",\ "group": "Mixed Martial Arts",\ "title": "MMA",\ "description": "Mixed Martial Arts",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "rugbyleague_nrl",\ "group": "Rugby League",\ "title": "NRL",\ "description": "Aussie Rugby League",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_australia_aleague",\ "group": "Soccer",\ "title": "A-League",\ "description": "Aussie Soccer",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_brazil_campeonato",\ "group": "Soccer",\ "title": "Brazil Série A",\ "description": "Brasileirão Série A",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_denmark_superliga",\ "group": "Soccer",\ "title": "Denmark Superliga",\ "description": "",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_finland_veikkausliiga",\ "group": "Soccer",\ "title": "Veikkausliiga - Finland",\ "description": "",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_japan_j_league",\ "group": "Soccer",\ "title": "J League",\ "description": "Japan Soccer League",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_league_of_ireland",\ "group": "Soccer",\ "title": "League of Ireland",\ "description": "Airtricity League Premier Division",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_norway_eliteserien",\ "group": "Soccer",\ "title": "Eliteserien - Norway",\ "description": "Norwegian Soccer",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_spain_segunda_division",\ "group": "Soccer",\ "title": "La Liga 2 - Spain",\ "description": "Spanish Soccer",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_sweden_allsvenskan",\ "group": "Soccer",\ "title": "Allsvenskan - Sweden",\ "description": "Swedish Soccer",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_sweden_superettan",\ "group": "Soccer",\ "title": "Superettan - Sweden",\ "description": "Swedish Soccer",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_uefa_european_championship",\ "group": "Soccer",\ "title": "UEFA Euro 2020",\ "description": "UEFA European Championship",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "soccer_usa_mls",\ "group": "Soccer",\ "title": "MLS",\ "description": "Major League Soccer",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "tennis_atp_french_open",\ "group": "Tennis",\ "title": "ATP French Open",\ "description": "Men's Singles",\ "active": true,\ "has_outrights": false\ },\ {\ "key": "tennis_wta_french_open",\ "group": "Tennis",\ "title": "WTA French Open",\ "description": "Women's Singles",\ "active": true,\ "has_outrights": false\ }\ ]\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers)\ Response Headers\ \ Calls to the /sports endpoint will not affect the quota usage. The following response headers are returned:\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs)\ Usage Quota Costs\ \ This endpoint does not count against the usage quota. \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ GET odds\ -------------------------------------------------------------------\ \ Returns a list of upcoming and live games with recent odds for a given sport, region and market\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-2)\ Endpoint\ \ **GET** /v4/sports/{sport}/odds/?apiKey={apiKey}®ions={regions}&markets={markets}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-2)\ Parameters\ \ * **sport**   The sport key obtained from calling the /sports endpoint. `upcoming` is always valid, returning any live games as well as the next 8 upcoming games across all sports\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ * **regions**   Determines the bookmakers to be returned. For example, `us`, `us2` (United States), `uk` (United Kingdom), `au` (Australia) and `eu` (Europe). Multiple regions can be specified if comma delimited. See the [list of bookmakers by region](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ .\ \ * **markets**   Optional - Determines which odds market is returned. Defaults to `h2h` (head to head / moneyline). Valid markets are `h2h` (moneyline), `spreads` (points handicaps), `totals` (over/under) and `outrights` (futures). Multiple markets can be specified if comma delimited. `spreads` and `totals` markets are mainly available for US sports and bookmakers at this time. Each specified market costs 1 against the usage quota, for each region.\ \ Lay odds are automatically included with `h2h` results for relevant betting exchanges (Betfair, Matchbook etc). These have a `h2h_lay` market key.\ \ For sports with outright markets (such as Golf), the market will default to `outrights` if not specified. Lay odds for outrights (`outrights_lay`) will automatically be available for relevant exchanges.\ \ For more info, see [descriptions of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ * **dateFormat**   Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `iso`.\ \ * **oddsFormat**   Optional - Determines the format of odds in the response. Valid values are `decimal` and `american`. Defaults to `decimal`. When set to `american`, small discrepancies might exist for some bookmakers due to rounding errors.\ \ * **eventIds**   Optional - Comma-separated game ids. Filters the response to only return games with the specified ids.\ \ * **bookmakers**   Optional - Comma-separated list of bookmakers to be returned. If both `bookmakers` and `regions` are both specified, `bookmakers` takes priority. Bookmakers can be from any region. Every group of 10 bookmakers is the equivalent of 1 region. For example, specifying up to 10 bookmakers counts as 1 region. Specifying between 11 and 20 bookmakers counts as 2 regions.\ \ * **commenceTimeFrom**   Optional - filter the response to show games that commence on and after this parameter. Values are in ISO 8601 format, for example 2023-09-09T00:00:00Z. This parameter has no effect if the sport is set to 'upcoming'.\ \ * **commenceTimeTo**   Optional - filter the response to show games that commence on and before this parameter. Values are in ISO 8601 format, for example 2023-09-10T23:59:59Z. This parameter has no effect if the sport is set to 'upcoming'.\ \ * **includeLinks**   Optional - if `true`, the response will include bookmaker links to events, markets, and betslips if available. Valid values are `true` or `false`\ \ * **includeSids**   Optional - if `true`, the response will include source ids (bookmaker ids) for events, markets and outcomes if available. Valid values are `true` or `false`. This field can be useful to construct your own links to handle variations in state or mobile app links.\ \ * **includeBetLimits**   Optional - if `true`, the response will include the bet limit of each betting option, mainly available for betting exchanges. Valid values are `true` or `false`\ \ * **includeRotationNumbers**   Optional - if `true`, the response will include the home and away rotation numbers if available. See [this link](https://the-odds-api.com/releases/rotation-numbers.html)\ for details. Valid values are `true` or `false`.\ \ \ \ \ Try it out in the browser\ \ [https://api.the-odds-api.com/v4/sports/upcoming/odds/?regions=... (opens new window)](https://api.the-odds-api.com/v4/sports/upcoming/odds/?regions=us&markets=h2h&apiKey=YOUR_API_KEY)\ \ Viewing JSON in the browser is easier with a prettifier such as [JSON Viewer (opens new window)](https://chrome.google.com/webstore/detail/json-viewer/gbmdgpbipfallnflgajpaliibnhdgobh)\ for Chrome\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-2)\ Schema\ \ For a detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/current%20events/get_v4_sports__sport__odds)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-2)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/americanfootball\_nfl/odds/?apiKey=YOUR\_API\_KEY®ions=us&markets=h2h,spreads&oddsFormat=american (opens new window)](https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds/?apiKey=YOUR_API_KEY®ions=us&markets=h2h,spreads&oddsFormat=american)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-2)\ Example Response\ \ [\ {\ "id": "bda33adca828c09dc3cac3a856aef176",\ "sport_key": "americanfootball_nfl",\ "commence_time": "2021-09-10T00:20:00Z",\ "home_team": "Tampa Bay Buccaneers",\ "away_team": "Dallas Cowboys",\ "bookmakers": [\ {\ "key": "unibet",\ "title": "Unibet",\ "last_update": "2021-06-10T13:33:18Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -303\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -109,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -111,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "caesars",\ "title": "Caesars",\ "last_update": "2021-06-10T13:33:48Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -278\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -110,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -110,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "sugarhouse",\ "title": "SugarHouse",\ "last_update": "2021-06-10T13:34:07Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -305\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -109,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -112,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2021-06-10T13:33:26Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -305\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -109,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -112,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "pointsbetus",\ "title": "PointsBet (US)",\ "last_update": "2021-06-10T13:36:20Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 230\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -291\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -110,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -110,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "betonlineag",\ "title": "BetOnline.ag",\ "last_update": "2021-06-10T13:37:29Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -286\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -105,\ "point": 6\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -115,\ "point": -6\ }\ ]\ }\ ]\ },\ {\ "key": "betmgm",\ "title": "BetMGM",\ "last_update": "2021-06-10T13:32:45Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 225\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -275\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -110,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -110,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "betrivers",\ "title": "BetRivers",\ "last_update": "2021-06-10T13:35:33Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -305\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -109,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -112,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2021-06-10T13:33:23Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 225\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -275\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -110,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -110,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "barstool",\ "title": "Barstool Sportsbook",\ "last_update": "2021-06-10T13:34:48Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -305\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -109,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -112,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "bovada",\ "title": "Bovada",\ "last_update": "2021-06-10T13:35:51Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -290\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -110,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -110,\ "point": -6.5\ }\ ]\ }\ ]\ },\ {\ "key": "williamhill_us",\ "title": "William Hill (US)",\ "last_update": "2021-06-10T13:34:10Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": 240\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -280\ }\ ]\ },\ {\ "key": "spreads",\ "outcomes": [\ {\ "name": "Dallas Cowboys",\ "price": -110,\ "point": 6.5\ },\ {\ "name": "Tampa Bay Buccaneers",\ "price": -110,\ "point": -6.5\ }\ ]\ }\ ]\ }\ ]\ },\ ...\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-2)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-2)\ Usage Quota Costs\ \ The usage quota cost is 1 per region per market.\ \ cost = [number of markets specified] x [number of regions specified]\ \ \ \ \ **Examples**\ \ * **1 market, 1 region** \ Cost: 1 \ Example `/v4/sports/americanfootball_nfl/odds?markets=h2h®ions=us&...`\ \ * **3 markets, 1 region** \ Cost: 3 \ Example `/v4/sports/americanfootball_nfl/odds?markets=h2h,spreads,totals®ions=us&...`\ \ * **1 market, 3 regions** \ Cost: 3 \ Example `/v4/sports/soccer_epl/odds?markets=h2h®ions=us,uk,eu&...`\ \ * **3 markets, 3 regions** \ Cost: 9 \ Example: `/v4/sports/basketball_nba/odds?markets=h2h,spreads,totals®ions=us,uk,au&...`\ \ \ \ \ Keeping track of quota usage\ \ To keep track of usage credits, every API call includes the following response headers:\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#more-info)\ More info\ \ * The list of events returned in the /odds endpoint mirrors events that are listed by major bookmakers. This usually includes games for the current round\ * Events may temporarily become unavailable after a round, before bookmakers begin listing the next round of games\ * Events may be unavailable if the sport is not in season. For popular sports, bookmakers may begin listing new season events a few months in advance\ * If no events are returned, the request will not count against the usage quota\ * To determine if an event is in-play, the `commence_time` can be used. If `commence_time` is less than the current time, the event is in-play. The /odds endpoint does not return completed events\ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-scores)\ GET scores\ -----------------------------------------------------------------------\ \ Returns a list of upcoming, live and recently completed games for a given sport. Live and recently completed games contain scores. Games from up to 3 days ago can be returned using the `daysFrom` parameter. Live scores update approximately every 30 seconds.\ \ The scores endpoint applies to selected sports and is gradually being expanded to more sports. See the current [list of covered sports and leagues](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ .\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-3)\ Endpoint\ \ **GET** /v4/sports/{sport}/scores/?apiKey={apiKey}&daysFrom={daysFrom}&dateFormat={dateFormat}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-3)\ Parameters\ \ * **sport**   The sport key obtained from calling the /sports endpoint.\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ * **daysFrom**   Optional - The number of days in the past from which to return completed games. Valid values are integers from `1` to `3`. If this parameter is missing, only live and upcoming games are returned.\ \ * **dateFormat**   Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `iso`.\ \ * **eventIds**   Optional - Comma-separated game ids. Filters the response to only return games for the specified game ids.\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-3)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/current%20events/get_v4_sports__sport__scores)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-3)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/basketball\_nba/scores/?daysFrom=1&apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports/basketball_nba/scores/?daysFrom=1&apiKey=YOUR_API_KEY)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-3)\ Example Response\ \ [\ {\ "id": "572d984e132eddaac3da93e5db332e7e",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T03:10:38Z",\ "completed": true,\ "home_team": "Sacramento Kings",\ "away_team": "Oklahoma City Thunder",\ "scores": [\ {\ "name": "Sacramento Kings",\ "score": "113"\ },\ {\ "name": "Oklahoma City Thunder",\ "score": "103"\ }\ ],\ "last_update": "2022-02-06T05:18:19Z"\ },\ {\ "id": "e2296d6d1206f8d185466876e2b444ea",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T03:11:26Z",\ "completed": true,\ "home_team": "Portland Trail Blazers",\ "away_team": "Milwaukee Bucks",\ "scores": [\ {\ "name": "Portland Trail Blazers",\ "score": "108"\ },\ {\ "name": "Milwaukee Bucks",\ "score": "137"\ }\ ],\ "last_update": "2022-02-06T05:21:01Z"\ },\ {\ "id": "8d8affc2e29bcafd3cdec8b414256cda",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T20:41:04Z",\ "completed": true,\ "home_team": "Denver Nuggets",\ "away_team": "Brooklyn Nets",\ "scores": [\ {\ "name": "Denver Nuggets",\ "score": "124"\ },\ {\ "name": "Brooklyn Nets",\ "score": "104"\ }\ ],\ "last_update": "2022-02-06T22:50:22Z"\ },\ {\ "id": "aae8b3294ab2de36e63c614e44e94d80",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T20:41:47Z",\ "completed": true,\ "home_team": "Minnesota Timberwolves",\ "away_team": "Detroit Pistons",\ "scores": [\ {\ "name": "Minnesota Timberwolves",\ "score": "118"\ },\ {\ "name": "Detroit Pistons",\ "score": "105"\ }\ ],\ "last_update": "2022-02-06T22:52:29Z"\ },\ {\ "id": "07767ff2952c6b025aa5584626db2910",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T20:42:13Z",\ "completed": true,\ "home_team": "Chicago Bulls",\ "away_team": "Philadelphia 76ers",\ "scores": [\ {\ "name": "Chicago Bulls",\ "score": "108"\ },\ {\ "name": "Philadelphia 76ers",\ "score": "119"\ }\ ],\ "last_update": "2022-02-06T22:58:23Z"\ },\ {\ "id": "3f63cadf65ad249c5bc6b1aac8ba426d",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T23:10:53Z",\ "completed": true,\ "home_team": "Orlando Magic",\ "away_team": "Boston Celtics",\ "scores": [\ {\ "name": "Orlando Magic",\ "score": "83"\ },\ {\ "name": "Boston Celtics",\ "score": "116"\ }\ ],\ "last_update": "2022-02-07T01:18:57Z"\ },\ {\ "id": "4843de62e910869ee34065ffe4c20137",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T23:11:42Z",\ "completed": true,\ "home_team": "Dallas Mavericks",\ "away_team": "Atlanta Hawks",\ "scores": [\ {\ "name": "Dallas Mavericks",\ "score": "103"\ },\ {\ "name": "Atlanta Hawks",\ "score": "94"\ }\ ],\ "last_update": "2022-02-07T01:26:29Z"\ },\ {\ "id": "e0f6669de3ae5af63162c3d9459184bf",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-06T23:12:42Z",\ "completed": true,\ "home_team": "Cleveland Cavaliers",\ "away_team": "Indiana Pacers",\ "scores": [\ {\ "name": "Cleveland Cavaliers",\ "score": "98"\ },\ {\ "name": "Indiana Pacers",\ "score": "85"\ }\ ],\ "last_update": "2022-02-07T01:36:15Z"\ },\ {\ "id": "a306576b1789dd1c884cc1aa61fda4bf",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-07T00:11:03Z",\ "completed": true,\ "home_team": "Houston Rockets",\ "away_team": "New Orleans Pelicans",\ "scores": [\ {\ "name": "Houston Rockets",\ "score": "107"\ },\ {\ "name": "New Orleans Pelicans",\ "score": "120"\ }\ ],\ "last_update": "2022-02-07T02:25:17Z"\ },\ {\ "id": "4b25562aa9e87b57aa16f970abaec8cc",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-07T02:11:01Z",\ "completed": false,\ "home_team": "Los Angeles Clippers",\ "away_team": "Milwaukee Bucks",\ "scores": [\ {\ "name": "Los Angeles Clippers",\ "score": "40"\ },\ {\ "name": "Milwaukee Bucks",\ "score": "37"\ }\ ],\ "last_update": "2022-02-07T02:47:23Z"\ },\ {\ "id": "19434a586e3723c55cd3d028b90eb112",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-08T00:10:00Z",\ "completed": false,\ "home_team": "Charlotte Hornets",\ "away_team": "Toronto Raptors",\ "scores": null,\ "last_update": null\ },\ {\ "id": "444e56cbf5a6d534741bb8d1298e2d50",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-08T01:10:00Z",\ "completed": false,\ "home_team": "Oklahoma City Thunder",\ "away_team": "Golden State Warriors",\ "scores": null,\ "last_update": null\ },\ {\ "id": "16d461b95e9d643d7f2469f72c098a20",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2022-02-08T02:10:00Z",\ "completed": false,\ "home_team": "Utah Jazz",\ "away_team": "New York Knicks",\ "scores": null,\ "last_update": null\ }\ ]\ \ \ \ Tip\ \ The game `id` field in the scores response matches the game `id` field in the odds response\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-3)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-3)\ Usage Quota Costs\ \ The usage quota cost is 2 if the `daysFrom` parameter is specified (returning completed events), otherwise the usage quota cost is 1.\ \ **Examples**\ \ * **Return live and upcoming games, and games completed within the last 3 days**\ \ Only live and completed games will have scores \ Cost: 2 \ Example `/v4/sports/americanfootball_nfl/scores?daysFrom=3&apiKey=...`\ \ * **Return live and upcoming games**\ \ Only live games will have scores \ Cost: 1 \ Example `/v4/sports/americanfootball_nfl/scores?apiKey=...`\ \ \ \ \ Keeping track of quota usage\ \ To keep track of usage credits, every API call includes the following response headers:\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ GET events\ -----------------------------------------------------------------------\ \ Returns a list of in-play and pre-match events for a specified sport or league. The response includes event id, home and away teams, and the commence time for each event. Odds are not included in the response. This endpoint does not count against the usage quota.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-4)\ Endpoint\ \ **GET** /v4/sports/{sport}/events?apiKey={apiKey}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-4)\ Parameters\ \ * **sport**   The sport key obtained from calling the /sports endpoint\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ * **dateFormat**   Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `iso`.\ \ * **eventIds**   Optional - Comma-separated game ids. Filters the response to only return games with the specified ids.\ \ * **commenceTimeFrom**   Optional - filter the response to show games that commence on and after this parameter. Values are in ISO 8601 format, for example 2023-09-09T00:00:00Z. This parameter has no effect if the sport is set to 'upcoming'.\ \ * **commenceTimeTo**   Optional - filter the response to show games that commence on and before this parameter. Values are in ISO 8601 format, for example 2023-09-10T23:59:59Z. This parameter has no effect if the sport is set to 'upcoming'.\ \ * **includeRotationNumbers**   Optional - if `true`, the response will include the home and away rotation numbers if available. See [this link](https://the-odds-api.com/releases/rotation-numbers.html)\ for details. Valid values are `true` or `false`.\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-4)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/current%20events/get_v4_sports__sport__events)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-4)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/americanfootball\_nfl/events?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events?apiKey=YOUR_API_KEY)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-4)\ Example Response\ \ [\ {\ "id": "a512a48a58c4329048174217b2cc7ce0",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-01-01T18:00:00Z",\ "home_team": "Atlanta Falcons",\ "away_team": "Arizona Cardinals"\ },\ {\ "id": "0ba747b1414a31b05ef37f0bf3d7fbe9",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-01-01T18:00:00Z",\ "home_team": "Tampa Bay Buccaneers",\ "away_team": "Carolina Panthers"\ },\ {\ "id": "d7120d8231032db343cb86b20cfaaf48",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-01-01T18:00:00Z",\ "home_team": "Detroit Lions",\ "away_team": "Chicago Bears"\ },\ {\ "id": "c7e2faa6faf714fbe08621a727604cd8",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-01-01T18:00:00Z",\ "home_team": "Washington Commanders",\ "away_team": "Cleveland Browns"\ },\ {\ "id": "2ed3fd0d267bbae31360e9f19d5adbab",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-01-01T18:00:00Z",\ "home_team": "Kansas City Chiefs",\ "away_team": "Denver Broncos"\ },\ ...\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-4)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-4)\ Usage Quota Costs\ \ This endpoint does not count against the usage quota.\ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ GET event odds\ -------------------------------------------------------------------------------\ \ Returns odds for a single event. Accepts [any available betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ using the `markets` parameter. Coverage of non-featured markets is currently limited to selected bookmakers and sports, and expanding over time.\ \ **When to use this endpoint**: Use this endpoint to access odds for any supported market. Since the volume of data returned can be large, these requests will only query one event at a time. If you are only interested in the most popular betting markets, including head-to-head (moneyline), point spreads (handicap), over/under (totals), the main [/odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ is simpler to integrate and more cost-effective.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-5)\ Endpoint\ \ **GET** /v4/sports/{sport}/events/{eventId}/odds?apiKey={apiKey}®ions={regions}&markets={markets}&dateFormat={dateFormat}&oddsFormat={oddsFormat}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-5)\ Parameters\ \ Parameters are the same as for the [/odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ with exceptions listed below. [All available market keys](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ are accepted in the markets parameter.\ \ * **eventId**   The id of an upcoming or live game, to be used in the URL path. Event ids can be found in the "id" field in the response of the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ \ * **includeMultipliers**   Optional. Applicable to US DFS sites. If `true`, the response will include the multipliers in each bet selection outcome if available. Valid values are `true` or `false`. Defaults to `false`.\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-5)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/current%20events/get_v4_sports__sport__events__eventId__odds)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-5)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/americanfootball\_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?apiKey=YOUR\_API\_KEY®ions=us&markets=player\_pass\_tds&oddsFormat=american (opens new window)](https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?apiKey=YOUR_API_KEY®ions=us&markets=player_pass_tds&oddsFormat=american)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-5)\ Example Response\ \ The response schema is almost the same as that of the [/odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ with a few differces:\ \ * A single game is returned, determined by the `eventId` parameter.\ * The `last_update` field is only available on the market level in the response and not on the bookmaker level. This reflects the fact that markets can update on their own schedule.\ * Relevant markets will have a `description` field in their outcomes.\ \ {\ "id": "a512a48a58c4329048174217b2cc7ce0",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-01-01T18:00:00Z",\ "home_team": "Atlanta Falcons",\ "away_team": "Arizona Cardinals",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "markets": [\ {\ "key": "player_pass_tds",\ "last_update": "2023-01-01T05:31:29Z",\ "outcomes": [\ {\ "name": "Over",\ "description": "David Blough",\ "price": -205,\ "point": 0.5\ },\ {\ "name": "Under",\ "description": "David Blough",\ "price": 150,\ "point": 0.5\ },\ {\ "name": "Over",\ "description": "Desmond Ridder",\ "price": -270,\ "point": 0.5\ },\ {\ "name": "Under",\ "description": "Desmond Ridder",\ "price": 195,\ "point": 0.5\ }\ ]\ }\ ]\ },\ {\ "key": "fanduel",\ "title": "FanDuel",\ "markets": [\ {\ "key": "player_pass_tds",\ "last_update": "2023-01-01T05:35:06Z",\ "outcomes": [\ {\ "name": "Over",\ "description": "David Blough",\ "price": -215,\ "point": 0.5\ },\ {\ "name": "Under",\ "description": "David Blough",\ "price": 164,\ "point": 0.5\ },\ {\ "name": "Over",\ "description": "Desmond Ridder",\ "price": 196,\ "point": 1.5\ },\ {\ "name": "Under",\ "description": "Desmond Ridder",\ "price": -260,\ "point": 1.5\ }\ ]\ }\ ]\ }\ ]\ }\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-5)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-5)\ Usage Quota Costs\ \ The usage quota cost depends on the number of markets and regions used in the request.\ \ cost = [number of unique markets returned] x [number of regions specified]\ \ \ \ \ **Examples of usage quota costs**\ \ * **1 market, 1 region** \ Cost: 1 \ Example `/v4/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=h2h®ions=us&...`\ \ * **3 markets, 1 region** \ Cost: 3 \ Example `/v4/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=h2h,spreads,totals®ions=us&...`\ \ * **1 market, 3 regions** \ Cost: 3 \ Example `/v4/sports/soccer_epl/events/037d7b6bb128546961e2a06680f63944/odds?markets=h2h®ions=us,uk,eu&...`\ \ * **3 markets, 3 regions** \ Cost: 9 \ Example: `/v4/sports/basketball_nba/events/0b83beff5f82f8623eea93dbc1d7cd4e/odds?markets=h2h,spreads,totals®ions=us,uk,au&...`\ \ \ \ \ Keeping track of quota usage\ \ To keep track of usage credits, every API response includes the following response headers:\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#more-info-2)\ More info\ \ * Responses with empty data do not count towards the usage quota.\ * When calculating the market component of usage quota costs, a count of unique markets in the API response is used. For example if you specify 5 different markets and 1 region in the API call, and data is only available for 2 markets, the cost will be \[2 markets\] x \[1 region\] = 2\ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-event-markets)\ GET event markets\ -------------------------------------------------------------------------------------\ \ Returns available market keys for each bookmaker for a single event.\ \ This endpoint only returns recently seen market keys for each bookmaker - it is not a comprehensive list of all supported markets. As an event's commence time approaches, this endpoint will return more market keys as bookmakers open more markets.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-6)\ Endpoint\ \ **GET** /v4/sports/{sport}/events/{eventId}/markets?apiKey={apiKey}®ions={regions}&dateFormat={dateFormat}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-6)\ Parameters\ \ * **sport**   The sport key obtained from calling the [sports endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-sports)\ .\ \ * **eventId**   The id of an upcoming or live game. Event ids can be found in the "id" field in the response of the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ * **regions**   Determines the bookmakers to be returned. For example, `us`, `us2` (United States), `uk` (United Kingdom), `au` (Australia) and `eu` (Europe). Multiple regions can be specified if comma delimited. See the [list of bookmakers by region](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ .\ \ * **bookmakers**   Optional - Comma-separated list of bookmakers to be returned. If both `bookmakers` and `regions` are both specified, `bookmakers` takes priority. Bookmakers can be from any region. Every group of 10 bookmakers is the equivalent of 1 region. For example, specifying up to 10 bookmakers counts as 1 region. Specifying between 11 and 20 bookmakers counts as 2 regions.\ \ * **dateFormat**   Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `iso`.\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-6)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/current%20events/get_v4_sports__sport__events__eventId__markets)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-6)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/baseball\_mlb/events/19699ba901294e39cb07fc4f19929a38/markets?apiKey=YOUR\_API\_KEY®ions=us (opens new window)](https://api.the-odds-api.com/v4/sports/baseball_mlb/events/19699ba901294e39cb07fc4f19929a38/markets?apiKey=YOUR_API_KEY®ions=us)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-6)\ Example Response\ \ {\ "id": "19699ba901294e39cb07fc4f19929a38",\ "sport_key": "baseball_mlb",\ "sport_title": "MLB",\ "commence_time": "2025-08-06T16:36:00Z",\ "home_team": "Philadelphia Phillies",\ "away_team": "Baltimore Orioles",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "markets": [\ {\ "key": "alternate_spreads",\ "last_update": "2025-08-06T07:39:57Z"\ },\ {\ "key": "batter_doubles",\ "last_update": "2025-08-06T07:39:57Z"\ },\ {\ "key": "batter_hits",\ "last_update": "2025-08-06T07:39:57Z"\ },\ {\ "key": "batter_home_runs",\ "last_update": "2025-08-06T07:39:57Z"\ },\ ...\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-6)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-6)\ Usage Quota Costs\ \ A call to this endpoint costs 1 usage credit.\ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-participants)\ GET participants\ -----------------------------------------------------------------------------------\ \ Returns list of participants for a given sport. Depending on the sport, a participant can be either a team or an individual. For example for NBA, a list of teams is returned. For tennis, a list of players is returned.\ \ This endpoint does not return players on a team.\ \ The returned list should be treated as a whitelist and may include participants that are not currently active.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-7)\ Endpoint\ \ **GET** /v4/sports/{sport}/participants?apiKey={apiKey}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-7)\ Parameters\ \ * **sport**   The sport key obtained from calling the /sports endpoint\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-7)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/default/get_v4_sports__sport__participants)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-7)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/sports/americanfootball\_nfl/participants?apiKey=YOUR\_API\_KEY (opens new window)](https://api.the-odds-api.com/v4/sports/americanfootball_nfl/participants?apiKey=YOUR_API_KEY)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-7)\ Example Response\ \ [\ {\ "full_name": "Arizona Cardinals",\ "id": "par_01hqmkr1xsfxmrj5pdq0f23asx"\ },\ {\ "full_name": "Atlanta Falcons",\ "id": "par_01hqmkr1xtexkbhkq7ct921rne"\ },\ {\ "full_name": "Baltimore Ravens",\ "id": "par_01hqmkr1xvev9rf557fy09k2cx"\ },\ {\ "full_name": "Buffalo Bills",\ "id": "par_01hqmkr1xwe6prjwr3j4gpqwx8"\ },\ {\ "full_name": "Carolina Panthers",\ "id": "par_01hqmkr1xxf2ebbqzb95qzxxxm"\ },\ {\ "full_name": "Chicago Bears",\ "id": "par_01hqmkr1xye20ahvp8fr2bvt74"\ },\ {\ "full_name": "Cincinnati Bengals",\ "id": "par_01hqmkr1xze7xbceshy9tka512"\ },\ {\ "full_name": "Cleveland Browns",\ "id": "par_01hqmkr1y0ez5bem3gdncd8a0d"\ },\ {\ "full_name": "Dallas Cowboys",\ "id": "par_01hqmkr1y1esas88pmaxe87by4"\ },\ {\ "full_name": "Denver Broncos",\ "id": "par_01hqmkr1y2e15tjsz9afcsj7da"\ },\ {\ "full_name": "Detroit Lions",\ "id": "par_01hqmkr1y3fex9sq94dgg1107y"\ },\ {\ "full_name": "Green Bay Packers",\ "id": "par_01hqmkr1y4ez38hyananses4hq"\ },\ {\ "full_name": "Houston Texans",\ "id": "par_01hqmkr1y5f63reha26n71p2jx"\ },\ {\ "full_name": "Indianapolis Colts",\ "id": "par_01hqmkr1y6f10rxbf8y2y2xthh"\ },\ {\ "full_name": "Jacksonville Jaguars",\ "id": "par_01hqmkr1y7e2r9kcn2qe0dt1d5"\ },\ {\ "full_name": "Kansas City Chiefs",\ "id": "par_01hqmkr1y8e9gt2q2rhmv196pv"\ },\ {\ "full_name": "Las Vegas Raiders",\ "id": "par_01hqmkr1y9fkaaeekn9w035jft"\ },\ {\ "full_name": "Los Angeles Chargers",\ "id": "par_01hqmkr1yafvas6wtv3jfs9f7a"\ },\ {\ "full_name": "Los Angeles Rams",\ "id": "par_01hqmkr1ybfmfb8mhz10drfe21"\ },\ {\ "full_name": "Miami Dolphins",\ "id": "par_01hqmkr1ycf7dsbr1997gz03y9"\ },\ {\ "full_name": "Minnesota Vikings",\ "id": "par_01hqmkr1ydf6vrfmd5f07caj88"\ },\ {\ "full_name": "New England Patriots",\ "id": "par_01hqmkr1yeffz9y9spwv8bx3na"\ },\ {\ "full_name": "New Orleans Saints",\ "id": "par_01hqmkr1yfe62tp0rvy8bn2jyc"\ },\ {\ "full_name": "New York Giants",\ "id": "par_01hqmkr1ygfzrv5sqe2v97c43e"\ },\ {\ "full_name": "New York Jets",\ "id": "par_01hqmkr1yhe4sb3y0wfzga67tf"\ },\ {\ "full_name": "Philadelphia Eagles",\ "id": "par_01hqmkr1yjedgakx37g743855e"\ },\ {\ "full_name": "Pittsburgh Steelers",\ "id": "par_01hqmkr1yker5bwcznt0b1jpj1"\ },\ {\ "full_name": "San Francisco 49ers",\ "id": "par_01hqmkr1ymfv0a8kfg96ha10ag"\ },\ {\ "full_name": "Seattle Seahawks",\ "id": "par_01hqmkr1ynfwaa91y9zvagkavd"\ },\ {\ "full_name": "Tampa Bay Buccaneers",\ "id": "par_01hqmkr1ypeszan8sq8dh7rqbg"\ },\ {\ "full_name": "Tennessee Titans",\ "id": "par_01hqmkr1yqexebpc06vyfwxqqm"\ },\ {\ "full_name": "Washington Commanders",\ "id": "par_01hqmkr1yrfsvbjjasn01a7xz4"\ }\ ]\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-7)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-7)\ Usage Quota Costs\ \ A call to this endpoint costs 1 usage credit.\ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ GET historical odds\ -----------------------------------------------------------------------------------------\ \ Returns a snapshot of games with bookmaker odds for a given sport, region and market, at a given historical timestamp. Historical odds data is available from June 6th 2020, with snapshots taken at 10 minute intervals. From September 2022, historical odds snapshots are available at 5 minute intervals. This endpoint is only available on paid usage plans.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-8)\ Endpoint\ \ **GET** /v4/historical/sports/{sport}/odds?apiKey={apiKey}®ions={regions}&markets={markets}&date={date}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-8)\ Parameters\ \ Parameters are the same as for the [/odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ , with the addition of the `date` parameter.\ \ * **date**   The timestamp of the data snapshot to be returned, specified in ISO8601 format, for example `2021-10-18T12:00:00Z` The historical odds API will return the closest snapshot equal to or earlier than the provided `date` parameter.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-8)\ Schema\ \ For a detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/historical%20events/get_v4_historical_sports__sport__odds)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-8)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/historical/sports/americanfootball\_nfl/odds/?apiKey=YOUR\_API\_KEY®ions=us&markets=h2h&oddsFormat=american&date=2021-10-18T12:00:00Z (opens new window)](https://api.the-odds-api.com/v4/historical/sports/americanfootball_nfl/odds/?apiKey=YOUR_API_KEY®ions=us&markets=h2h&oddsFormat=american&date=2021-10-18T12:00:00Z)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-8)\ Example Response\ \ The response schema is the same as that of the [/odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ , but wrapped in a structure that contains information about the snapshot, including:\ \ * timestamp: The timestamp of the snapshot. This will be the closest available timestamp equal to or earlier than the provided `date` parameter.\ * previous\_timestamp: the preceding available timestamp. This can be used as the `date` parameter in a new request to move back in time.\ * next\_timestamp: The next available timestamp. This can be used as the `date` parameter in a new request to move forward in time.\ \ [More sample responses for selected sports](https://the-odds-api.com/historical-odds-data/#sample-historical-odds-data)\ \ {\ "timestamp": "2021-10-18T11:55:00Z",\ "previous_timestamp": "2021-10-18T11:45:00Z",\ "next_timestamp": "2021-10-18T12:05:00Z",\ "data": [\ {\ "id": "4edd5ce090a3ec6192053b10d27b87b0",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2021-10-19T00:15:00Z",\ "home_team": "Tennessee Titans",\ "away_team": "Buffalo Bills",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2021-10-18T11:48:09Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -294\ },\ {\ "name": "Tennessee Titans",\ "price": 230\ }\ ]\ }\ ]\ },\ {\ "key": "twinspires",\ "title": "TwinSpires",\ "last_update": "2021-10-18T11:48:00Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -278\ },\ {\ "name": "Tennessee Titans",\ "price": 220\ }\ ]\ }\ ]\ },\ {\ "key": "betfair",\ "title": "Betfair",\ "last_update": "2021-10-18T11:48:25Z",\ "markets": [\ {\ "key": "h2h_lay",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -233\ },\ {\ "name": "Tennessee Titans",\ "price": 240\ }\ ]\ },\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -238\ },\ {\ "name": "Tennessee Titans",\ "price": 230\ }\ ]\ }\ ]\ },\ {\ "key": "sugarhouse",\ "title": "SugarHouse",\ "last_update": "2021-10-18T11:48:27Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -263\ },\ {\ "name": "Tennessee Titans",\ "price": 228\ }\ ]\ }\ ]\ },\ {\ "key": "betrivers",\ "title": "BetRivers",\ "last_update": "2021-10-18T11:45:46Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -263\ },\ {\ "name": "Tennessee Titans",\ "price": 228\ }\ ]\ }\ ]\ },\ {\ "key": "barstool",\ "title": "Barstool Sportsbook",\ "last_update": "2021-10-18T11:48:21Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -278\ },\ {\ "name": "Tennessee Titans",\ "price": 220\ }\ ]\ }\ ]\ },\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2021-10-18T11:47:58Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -270\ },\ {\ "name": "Tennessee Titans",\ "price": 220\ }\ ]\ }\ ]\ },\ {\ "key": "betmgm",\ "title": "BetMGM",\ "last_update": "2021-10-18T11:44:23Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -250\ },\ {\ "name": "Tennessee Titans",\ "price": 210\ }\ ]\ }\ ]\ },\ {\ "key": "unibet",\ "title": "Unibet",\ "last_update": "2021-10-18T11:49:57Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -263\ },\ {\ "name": "Tennessee Titans",\ "price": 225\ }\ ]\ }\ ]\ },\ {\ "key": "williamhill_us",\ "title": "William Hill (US)",\ "last_update": "2021-10-18T11:48:21Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -270\ },\ {\ "name": "Tennessee Titans",\ "price": 220\ }\ ]\ }\ ]\ },\ {\ "key": "betonlineag",\ "title": "BetOnline.ag",\ "last_update": "2021-10-18T11:48:28Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -256\ },\ {\ "name": "Tennessee Titans",\ "price": 215\ }\ ]\ }\ ]\ },\ {\ "key": "pointsbetus",\ "title": "PointsBet (US)",\ "last_update": "2021-10-18T11:48:46Z",\ "markets": [\ {\ "key": "h2h",\ "outcomes": [\ {\ "name": "Buffalo Bills",\ "price": -263\ },\ {\ "name": "Tennessee Titans",\ "price": 210\ }\ ]\ }\ ]\ },\ ...\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-8)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-8)\ Usage Quota Costs\ \ The usage quota cost for historical odds is 10 per region per market.\ \ cost = 10 x [number of markets specified] x [number of regions specified]\ \ \ \ \ **Examples of usage quota costs for historical odds**\ \ * **1 market, 1 region** \ Cost: 10 \ Example `/v4/historical/sports/americanfootball_nfl/odds?markets=h2h®ions=us&...`\ \ * **3 markets, 1 region** \ Cost: 30 \ Example `/v4/historical/sports/americanfootball_nfl/odds?markets=h2h,spreads,totals®ions=us&...`\ \ * **1 market, 3 regions** \ Cost: 30 \ Example `/v4/historical/sports/soccer_epl/odds?markets=h2h®ions=us,uk,eu&...`\ \ * **3 markets, 3 regions** \ Cost: 90 \ Example: `/v4/historical/sports/basketball_nba/odds?markets=h2h,spreads,totals®ions=us,uk,au&...`\ \ \ \ \ Keeping track of quota usage\ \ To keep track of usage credits, every API response includes the following response headers:\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#more-info-3)\ More info\ \ * Responses with empty data do not count towards the usage quota.\ * Prior to Septemer 18th 2022, only decimal odds were caputred in historical snapshots. American odds before this time are calculated from decimal odds and may include small rounding errors.\ * Data errors aren't common but they can occur from time to time. We are usually quick to correct errors in the current odds API, however they can still be present in historical odds snapshots. In future we plan to remove known errors from historical snapshots.\ * Bookmakers, sports and markets will only be available in the historical odds API from the time that they were added to the current odds API.\ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-historical-events)\ GET historical events\ ---------------------------------------------------------------------------------------------\ \ Returns a list of historical events as they appeared in the API at the given timestamp (`date` parameter). The response includes event id, home and away teams, and the commence time for each event. Odds are not included in the response. This endpoint can be used to find historical event ids to be used in the [historical event odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-event-odds)\ . This endpoint is only available on paid usage plans.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-9)\ Endpoint\ \ **GET** /v4/historical/sports/{sport}/events?apiKey={apiKey}&date={date}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-9)\ Parameters\ \ * **sport**   The sport key obtained from calling the /sports endpoint\ \ * **apiKey**   The API key associated with your subscription. [See usage plans](https://the-odds-api.com/#get-access)\ \ * **date**   The timestamp of the data snapshot to be returned, specified in ISO8601 format, for example `2021-10-18T12:00:00Z` The historical odds API will return the closest snapshot equal to or earlier than the provided `date` parameter.\ \ * **dateFormat**   Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `iso`.\ \ * **eventIds**   Optional - Comma-separated game ids. Filters the response to only return games with the specified ids.\ \ * **commenceTimeFrom**   Optional - filter the response to show games that commence on and after this parameter. Values are in ISO 8601 format, for example 2023-09-09T00:00:00Z. This parameter has no effect if the sport is set to 'upcoming'.\ \ * **commenceTimeTo**   Optional - filter the response to show games that commence on and before this parameter. Values are in ISO 8601 format, for example 2023-09-10T23:59:59Z. This parameter has no effect if the sport is set to 'upcoming'.\ \ * **includeRotationNumbers**   Optional - if `true`, the response will include the home and away rotation numbers if available. See [this link](https://the-odds-api.com/releases/rotation-numbers.html)\ for details. Valid values are `true` or `false`.\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-9)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/historical%20events/get_v4_historical_sports__sport__events)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-9)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/historical/sports/basketball\_nba/events?apiKey=YOUR\_API\_KEY&date=2023-11-29T22:42:00Z (opens new window)](https://api.the-odds-api.com/v4/historical/sports/basketball_nba/events?apiKey=YOUR_API_KEY&date=2023-11-29T22:42:00Z)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-9)\ Example Response\ \ The response schema is almost the same as that of the [/events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ , but wrapped in a structure that contains information about the snapshot, including:\ \ * timestamp: The timestamp of the snapshot. This will be the closest available timestamp equal to or earlier than the provided date parameter.\ * previous\_timestamp: the preceding available timestamp. This can be used as the date parameter in a new request to move back in time.\ * next\_timestamp: The next available timestamp. This can be used as the date parameter in a new request to move forward in time.\ \ {\ "timestamp": "2023-11-29T22:40:39Z",\ "previous_timestamp": "2023-11-29T22:35:39Z",\ "next_timestamp": "2023-11-29T22:45:40Z",\ "data": [\ {\ "id": "da359da99aa27e97d38f2df709343998",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2023-11-30T00:10:00Z",\ "home_team": "Detroit Pistons",\ "away_team": "Los Angeles Lakers"\ },\ {\ "id": "0a502b246aa29f8ac2edb7a3ddf71ae9",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2023-11-30T00:10:00Z",\ "home_team": "Orlando Magic",\ "away_team": "Washington Wizards"\ },\ {\ "id": "2667f897a67e6cdad61bd26a3b941d83",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2023-11-30T00:40:00Z",\ "home_team": "Toronto Raptors",\ "away_team": "Phoenix Suns"\ },\ ...\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-9)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-9)\ Usage Quota Costs\ \ This endpoint costs 1 from usage quota. If no events are found, it will not cost.\ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#get-historical-event-odds)\ GET historical event odds\ -----------------------------------------------------------------------------------------------------\ \ Returns historical odds for a single event as they appeared at a specified timestamp. Accepts [any available betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ using the `markets` parameter. Historical data for additional markets (player props, alternate lines, period markets) are available after 2023-05-03T05:30:00Z. This endpoint is only available on paid usage plans.\ \ Tip\ \ When querying historical odds for [featured markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#featured-betting-markets)\ , the [historical odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ is simpler to implement and more cost-effective.\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#endpoint-10)\ Endpoint\ \ **GET** /v4/historical/sports/{sport}/events/{eventId}/odds?apiKey={apiKey}®ions={regions}&markets={markets}&dateFormat={dateFormat}&oddsFormat={oddsFormat}&date={date}\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#parameters-10)\ Parameters\ \ Parameters are the same as for the [/odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ , with additional parameters listed below. [All available market keys](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ are accepted in the markets parameter.\ \ * **eventId**   The id of a historical game, to be used in the URL path. Historical event ids can be found in the "id" field in the response of the [historical events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-events)\ .\ \ * **date**   The timestamp of the data snapshot to be returned, specified in ISO8601 format, for example `2023-11-29T22:42:00Z` The historical odds API will return the closest snapshot equal to or earlier than the provided `date` parameter. Historical data for additional markets are available after 2023-05-03T05:30:00Z. Snapshots are available at 5 minute intervals.\ \ * **includeMultipliers**   Optional. Applicable to US DFS sites. If `true`, the response will include the multipliers in each bet selection outcome if available. Valid values are `true` or `false`. Defaults to `false`.\ \ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#schema-10)\ Schema\ \ For the detailed API spec, see the [Swagger API docs (opens new window)](https://app.swaggerhub.com/apis-docs/the-odds-api/odds-api/4#/historical%20events/get_v4_historical_sports__sport__events__eventId__odds)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-request-10)\ Example Request\ \ **GET** [https://api.the-odds-api.com/v4/historical/sports/basketball\_nba/events/da359da99aa27e97d38f2df709343998/odds?apiKey=YOUR\_API\_KEY&date=2023-11-29T22:45:00Z®ions=us&markets=player\_points,h2h\_q1 (opens new window)](https://api.the-odds-api.com/v4/historical/sports/basketball_nba/events/da359da99aa27e97d38f2df709343998/odds?apiKey=YOUR_API_KEY&date=2023-11-29T22:45:00Z®ions=us&markets=player_points,h2h_q1)\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#example-response-10)\ Example Response\ \ The response schema is almost the same as that of the [/event odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ , but wrapped in a structure that contains information about the snapshot, including:\ \ * timestamp: The timestamp of the snapshot. This will be the closest available timestamp equal to or earlier than the provided date parameter.\ * previous\_timestamp: the preceding available timestamp. This can be used as the date parameter in a new request to move back in time.\ * next\_timestamp: The next available timestamp. This can be used as the date parameter in a new request to move forward in time.\ \ {\ "timestamp": "2023-11-29T22:40:39Z",\ "previous_timestamp": "2023-11-29T22:35:39Z",\ "next_timestamp": "2023-11-29T22:45:40Z",\ "data": {\ "id": "da359da99aa27e97d38f2df709343998",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2023-11-30T00:10:00Z",\ "home_team": "Detroit Pistons",\ "away_team": "Los Angeles Lakers",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-11-29T22:40:09Z",\ "markets": [\ {\ "key": "h2h_q1",\ "last_update": "2023-11-29T22:40:55Z",\ "outcomes": [\ {\ "name": "Detroit Pistons",\ "price": 2.5\ },\ {\ "name": "Los Angeles Lakers",\ "price": 1.56\ }\ ]\ },\ {\ "key": "player_points",\ "last_update": "2023-11-29T22:40:55Z",\ "outcomes": [\ {\ "name": "Over",\ "description": "Anthony Davis",\ "price": 1.83,\ "point": 23.5\ },\ {\ "name": "Under",\ "description": "Anthony Davis",\ "price": 1.91,\ "point": 23.5\ },\ {\ "name": "Over",\ "description": "Ausar Thompson",\ "price": 1.87,\ "point": 11.5\ },\ {\ "name": "Under",\ "description": "Ausar Thompson",\ "price": 1.87,\ "point": 11.5\ },\ {\ "name": "Over",\ "description": "Cade Cunningham",\ "price": 1.91,\ "point": 23.5\ },\ {\ "name": "Under",\ "description": "Cade Cunningham",\ "price": 1.83,\ "point": 23.5\ },\ {\ "name": "Over",\ "description": "D'Angelo Russell",\ "price": 1.87,\ "point": 14.5\ },\ ...\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#response-headers-10)\ Response Headers\ \ The following response headers are returned\ \ * **x-requests-remaining**   The usage credits remaining until the quota resets\ * **x-requests-used**   The usage credits used since the last quota reset\ * **x-requests-last**   The usage cost of the last API call\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#usage-quota-costs-10)\ Usage Quota Costs\ \ The usage quota cost depends on the number of markets and regions used in the request.\ \ cost = 10 x [number of unique markets returned] x [number of regions specified]\ \ \ \ \ **Examples of usage quota costs**\ \ * **1 market, 1 region** \ Cost: 10 \ Example `/v4/historical/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=player_pass_tds®ions=us&...`\ \ * **3 markets, 1 region** \ Cost: 30 \ Example `/v4/historical/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=player_pass_tds,player_anytime_td,player_rush_longest®ions=us&...`\ \ * **1 market, 3 regions** \ Cost: 30 \ Example `/v4/historical/sports/basketball_nba/events/037d7b6bb128546961e2a06680f63944/odds?markets=player_points®ions=us,us2,au&...`\ \ * **3 markets, 3 regions** \ Cost: 90 \ Example: `/v4/historical/sports/basketball_nba/events/0b83beff5f82f8623eea93dbc1d7cd4e/odds?markets=player_points,player_assists,alternate_spreads®ions=us,us2,au&...`\ \ \ \ \ Keeping track of quota usage\ \ To keep track of usage credits, every API response includes the following response headers:\ \ * x-requests-used\ * x-requests-remaining\ * x-requests-last\ \ ### [#](https://the-odds-api.com/liveapi/guides/v4/#more-info-4)\ More info\ \ * Responses with empty data do not count towards the usage quota.\ * When calculating the market component of usage quota costs, a count of unique markets in the API response is used. For example if you specify 5 different markets and 1 region in the API call, and data is only available for 2 markets, the cost will be 10 x \[2 markets\] x \[1 region\] = 20\ \ \ \ \ [#](https://the-odds-api.com/liveapi/guides/v4/#rate-limiting-status-code-429)\ Rate Limiting (status code 429)\ ---------------------------------------------------------------------------------------------------------------\ \ Requests are rate limited in order to protect our systems from sudden bursts in traffic. If you enounter the rate limit, the API will respond with a status code of 429, in which case try spacing out requests over several seconds. More information can be [found here](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#exceeded-freq-limit)\ .\ \ [#](https://the-odds-api.com/liveapi/guides/v4/#code-samples)\ Code Samples\ ---------------------------------------------------------------------------\ \ Get started right away with [code samples for Python and NodeJs](https://the-odds-api.com/liveapi/guides/v4/samples.html)\ . Code samples are also available on [Github (opens new window)](https://github.com/the-odds-api)\ \ [#](https://the-odds-api.com/liveapi/guides/v4/#more-info-5)\ More Info\ -----------------------------------------------------------------------\ \ Stay up to date on new sports, bookmakers and features by [following us on Twitter (opens new window)](https://twitter.com/The_Odds_API) --- # The Odds API FAQs | The Odds API [#](https://the-odds-api.com/manage/faqs.html#the-odds-api-faqs) The Odds API FAQs =================================================================================== Q What happens when I subscribe? You will receive an email containing your API key and links to help you get started. Q When am I billed? For paid plans, billing happens straight away. Payment then happens automatically each month thereafter, on the same day of the month that the subscription started. For example if the first payment happens on the 1st of the month, you will be charged on the 1st for subsequent months. Q How can I cancel? You can cancel your subscription at any time using [this form](https://the-odds-api.com/manage/cancel.html) or in the [accounts portal](https://the-odds-api.com/account/) . Your subscription will automatically cancel before the next billing cycle. Q What is a request? A single request returns live and upcoming games for a given **sport**, betting **market**, and bookmaker **region**. Each game includes a start time, participants, and bookmaker odds for the specified region. **Example**: if you request odds for basketball NBA, from US-region bookmakers, and moneyline betting markets, the API will return live and upcoming NBA games, showing moneyline odds from US bookmakers. This will count as 1 request from your plan's usage quota. Q How frequently are odds updated? More info on odds update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . Q When are usage credits reset? Usage credits are automatically reset on the first of every month. Q How can I update my credit card details? Billing details can be managed with an [account](https://the-odds-api.com/account) . When creating an account for the first time, be sure to use the same email that was used for any existing subscriptions. Q How can I get in touch? Contact us at [team@the-odds-api.com](mailto:team@the-odds-api.com) (or respond to the email that delivers your API key) Q What if I'm not a programmer? You can easily access all live sports odds data with your API key in [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) or [Excel](https://the-odds-api.com/features/excel.html) . Find out more about the [Google Sheets add-on](https://the-odds-api.com/features/spreadsheets.html) and the [Excel add-on](https://the-odds-api.com/features/excel.html) . Q What if I find an error? Normally a marketing home page won’t make any mention of errors in a data service, but the reality is that at any given time, we cover hundreds of games and thousands of odds from over 50 sources and growing, and the data is constantly changing. We have systems in place to detect various kinds of anomalies but we can’t catch everything and occasionally errors occur. On the occasion that errors are brought to our attention, and we aim to address them as a matter of priority. If you notice an error relating to a specific bookmaker, please compare the API response with the bookmaker’s website before alerting us. When raising the error, try to include the full API url that was being called, and if relevant, screenshots of the bookmaker's website and the API response. To raise an error, simply email us at team@the-odds-api.com Learn more about The Odds API by [signing up to a free plan →](https://the-odds-api.com/) --- # Odds Widget FAQs | The Odds API [#](https://the-odds-api.com/manage/faqs-widget.html#odds-widget-faqs) Odds Widget FAQs ======================================================================================== Q When am I billed? For paid plans, billing happens straight away. Payment then happens automatically each month thereafter, on the same day of the month that the subscription started. For example if the first payment happens on the 1st of the month, you will be charged on the 1st for subsequent months. Q What is a visit? Each time a widget HTML tag is loaded (typically on a website visit), it will count as 1 visit from the usage quota. Q How can I cancel? A subscription can be cancelled from your account. * Log into [your account](https://the-odds-api.com/account/?path=widget-subscriptions) * Click "Manage Subscription" on the relevant subscription * Click "Cancel plan" Q How frequently are odds updated? Having recently launched, odds in the widget can be delayed by up to 20 minutes. We plan to reduce this significantly in the near term in response to feedback. Feel free to share feedback at [team@the-odds-api.com](mailto:team@the-odds-api.com) Q How can I update my credit card details? Billing details can be managed in your account. * Log into [your account](https://the-odds-api.com/account/?path=widget-subscriptions) * Click "Manage Subscription" on the relevant subscription * Click "Add payment method" Q How can I get in touch? Contact us at [team@the-odds-api.com](mailto:team@the-odds-api.com) (or respond to the email that delivers your access key) Q What if I find an error? We strive for accuracy but with thousands of odds listed at any given time, errors can occasionally occur. If you spot an error, [let us know](mailto:team@the-odds-api.com) and we’ll try and correct it ASAP. Learn more about the Odds Widget by [signing up to a free plan →](https://the-odds-api.com/widget) --- # API Error Codes | The Odds API [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#api-error-codes) API Error Codes ===================================================================================================== This page lists API error codes and their common causes. If you encounter an error that is not documented on this page, it can be reported to [team@the-odds-api.com](mailto:team@the-odds-api.com) . Be sure to include the full API URL that caused the error. Errors can depend on the specific endpoint being called. For details on specific endpoints and example API requests, see [the docs](https://the-odds-api.com/liveapi/guides/v4/) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#missing-key) MISSING\_KEY ---------------------------------------------------------------------------------------------- An `apiKey` query parameter is required for all calls to the API, for example `https://api.the-odds-api.com/v4/sports?apiKey=YOUR_API_KEY` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-key) INVALID\_KEY ---------------------------------------------------------------------------------------------- The API key was invalid or not associated with a subscription. For sample URLs, the API key is commonly `YOUR_API_KEY` or `{apiKey}`, in which case it will need to be replaced with a valid API key associated with [a subscription](https://the-odds-api.com/#get-access) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#deactivated-key) DEACTIVATED\_KEY ------------------------------------------------------------------------------------------------------ The API key has been deactivated, most commonly due to subscription cancelation. To regain access to the API, a [new subscription](https://the-odds-api.com/#get-access) is required. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#exceeded-freq-limit) EXCEEDED\_FREQ\_LIMIT --------------------------------------------------------------------------------------------------------------- The request was rate-limited (HTTP status code 429). Reduce the number of API calls being sent concurrently by spacing out API calls over several seconds. The rate limit is currently 30 API calls per second. There are a couple of reasons that 429s can occur: * If our system receives a large increase in traffic, it will take some time to scale up, usually in the order of minutes. Whilst this is happening, some requests might be knocked back with 429s. * If requests are sent at a rate close to the limit, some requests can still trigger rate limiting since our servers can receive requests at a different rate to which they are sent. For example, if you send 30 requests per second for 2 seconds, our servers might receive 25 requests in the first second, 33 in the next second (3 of which will be limited), and the remaining 2 requests after that. The rate at which our systems receive the requests will depend on network conditions, which are influenced by many factors outside of our control. Both of these scenarios mean that 429s can occur sometimes, and they are more likely if requests are being sent close to the limit. To handle a request that has been rate limited, consider retrying the request after a couple of seconds. Also avoid unnecessary API calls. For example, API calls to the sports or events endpoints can be made infrequently, since the responses don't change often. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#out-of-usage-credits) OUT\_OF\_USAGE\_CREDITS ------------------------------------------------------------------------------------------------------------------ The usage credit limit of the subscription has been reached for the month. Usage credits can be monitored by accessing the HTTP response headers, which are returned with every API call: * `x-requests-remaining` The usage credits remaining until the quota resets * `x-requests-used` The usage credits used since the last quota reset * `x-requests-last` The usage cost of the last API call Usage can be tracked and subscriptions can be changed in the [accounts portal](https://the-odds-api.com/account/) . If you have not already done so, you will need to create a new account, even if you have active subscriptions. A new account can be [created here](https://the-odds-api.com/account/?initialAuthState=signUp) . ### [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#troubleshooting-unexpected-usage) Troubleshooting Unexpected Usage If usage is higher than expected, these tips might help identify the cause: * Be sure to familiarize yourself with usage quota costs of API calls. This will depend on the endpoint being called. Details and examples can be found in the "Usage Quota Costs" section of relevant endpoints in [the docs](https://the-odds-api.com/liveapi/guides/v4/) . * If an unexpected increase in usage corresponds with recent code changes, check if a bug was recently added to your code. * Consider if you have any automated scripts running which may have been forgotten. * Your API key may have fallen into the hands of an unauthorized user. This can happen if the API key was committed to a public repository, or if it was used on the frontend of a public facing website. An API key can be regenerated in the [accounts portal](https://the-odds-api.com/account/) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#missing-region) MISSING\_REGION ---------------------------------------------------------------------------------------------------- The endpoint being called requires a `regions` query parameter, which specifies regions of bookmakers to be queried, for example `®ions=us,uk` Alternatively the `bookmakers` parameter can be used, for example `&bookmakers=draftkings,pinnacle` A list of valid bookmakers and regions can be [found here](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-region) INVALID\_REGION ---------------------------------------------------------------------------------------------------- One or more of the specified regions is invalid. A list of valid bookmaker regions can be [found here](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . Multiple comma-separated regions can be specified, for example `https://api.the-odds-api.com/v4/sports/soccer_epl/odds?apiKey=YOUR_API_KEY&markets=h2h®ions=uk,eu` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-bookmakers) INVALID\_BOOKMAKERS ------------------------------------------------------------------------------------------------------------ The `bookmakers` parameter can be used as an alternative to the `regions` parameter. The `bookmakers` parameter is a comma-separated list of one or more bookmaker keys. A list of bookmaker keys can be [found here](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . Multiple comma-separated bookmaker keys can be specified. Bookmakers can be from any region, for example `https://api.the-odds-api.com/v4/sports/basketball_nba/odds?apiKey=YOUR_API_KEY&markets=h2h&bookmakers=draftkings,fanduel,pinnacle` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#missing-market) MISSING\_MARKET ---------------------------------------------------------------------------------------------------- The endpoint being called requires a `markets` query parameter, which specifies betting markets to be queried. For most endpoints, this parameter is not required and will default to the `h2h` market. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-market) INVALID\_MARKET ---------------------------------------------------------------------------------------------------- One or more of the markets being queried are invalid or unsupported by the endpoint being used. A list of valid market keys can be [found here](https://the-odds-api.com/sports-odds-data/betting-markets.html) . This error is commonly caused when non-featured markets are used with the odds or historical odds endpoints, which only support [featured markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#featured-betting-markets) . [Non-featured markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#additional-markets) , such as player props, period markets and alternate markets can be queried one event at a time using the [event-odds](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) or [historical-event-odds](https://the-odds-api.com/liveapi/guides/v4/#get-historical-event-odds) endpoints. For example, this will cause an error since player\_points is a non-featured market, and the odds endpoint only accepts featured markets: `https://api.the-odds-api.com/v4/sports/basketball_nba/odds?apiKey=YOUR_API_KEY®ions=us&oddsFormat=american&markets=player_points` The events-odds endpoint accepts any markets. In this example, b308ed60cbb2d1324946c7289190cc88 was the event id of the Timberwolves @ Nuggets game on 2024-05-04. The event id will need to be replaced with a current event id, which can be obtained from the [events](https://the-odds-api.com/liveapi/guides/v4/#get-events) endpoint. `https://api.the-odds-api.com/v4/sports/basketball_nba/events/b308ed60cbb2d1324946c7289190cc88/odds?apiKey=YOUR_API_KEY®ions=us&oddsFormat=american&markets=player_points` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-market-combo) INVALID\_MARKET\_COMBO ----------------------------------------------------------------------------------------------------------------- This error usually occurs if the sportKey represents an outrights (futures) event, in which case the valid market is `outrights`. For example this will cause the error: `https://api.the-odds-api.com/v4/sports/americanfootball_nfl_super_bowl_winner/odds?apiKey=YOUR_API_KEY®ions=us&oddsFormat=american&markets=h2h` This is a valid combination `https://api.the-odds-api.com/v4/sports/americanfootball_nfl_super_bowl_winner/odds?apiKey=YOUR_API_KEY®ions=us&oddsFormat=american&markets=outrights` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-date-format) INVALID\_DATE\_FORMAT --------------------------------------------------------------------------------------------------------------- The specified `dateFormat` query parameter is invalid. For valid formats, see the "parameters" section for the relevant endpoint in [the docs](https://the-odds-api.com/liveapi/guides/v4/) . The `dateFormat` parameter is not required for most endpoints, and will default to `iso` (ISO8601). [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-odds-format) INVALID\_ODDS\_FORMAT --------------------------------------------------------------------------------------------------------------- The specified `oddsFormat` query parameter is invalid. For valid formats, see the "parameters" section for the relevant endpoint in [the docs](https://the-odds-api.com/liveapi/guides/v4/) . If this parameter is missing, the `oddsFormat` will default to `decimal`. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-all-sports-param) INVALID\_ALL\_SPORTS\_PARAM -------------------------------------------------------------------------------------------------------------------------- The `all` query parameter must be `true` or `false`. This will likely be relevant for the [sports endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-sports) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-sport) INVALID\_SPORT -------------------------------------------------------------------------------------------------- The sport path parameter is missing or invalid. A list of valid sport keys can be [found here](https://the-odds-api.com/sports-odds-data/sports-apis.html) , or by called the [sports endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-sports) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#unknown-sport) UNKNOWN\_SPORT -------------------------------------------------------------------------------------------------- The specified sport is not found. A list of valid sport keys can be [found here](https://the-odds-api.com/sports-odds-data/sports-apis.html) , or by called the [sports endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-sports) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-scores-days-from) INVALID\_SCORES\_DAYS\_FROM -------------------------------------------------------------------------------------------------------------------------- The `daysFrom` parameter must be an integer greater than or equal to 1, and less the maximum specified in [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-scores) (see the "parameters" section of the relevant endpoint). For example `https://api.the-odds-api.com/v4/sports/baseball_mlb/scores?apiKey=YOUR_API_KEY&daysFrom=2` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-event-ids) INVALID\_EVENT\_IDS ----------------------------------------------------------------------------------------------------------- The `eventIds` query parameter is invalid. For endpoints that return a list of events, this parameter is used to filter the API response to specific events. This parameter must contain comma separated event ids, each of which is 32 characters in length. Depending on the endpoint being queried, event ids can be found by calling the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events) or the [historical events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-events) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-event-id) INVALID\_EVENT\_ID --------------------------------------------------------------------------------------------------------- The event id parameter in the URL path is invalid. The event id must be 32 characters in length. Depending on the endpoint being queried, event ids can be found by calling the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events) or the [historical events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-historical-events) . For example, c163b5f5f4579c8293266956ccf3d9bd is the event id for Tampa Bay Rays @ Los Angeles Angels on 2024-04-09: `https://api.the-odds-api.com/v4/historical/sports/baseball_mlb/events/c163b5f5f4579c8293266956ccf3d9bd/odds?apiKey=YOUR_API_KEY&markets=totals_1st_5_innings®ions=us&oddsFormat=american&date=2024-04-08T15:10:00Z` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#event-not-found) EVENT\_NOT\_FOUND ------------------------------------------------------------------------------------------------------- The event id specified in the URL path was not found. The most common cause is that the event has concluded. This error can also occur if the event id was not correctly specified. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#missing-historical-timestamp) MISSING\_HISTORICAL\_TIMESTAMP --------------------------------------------------------------------------------------------------------------------------------- The `date` parameter is required when querying historical endpoints. This represents the timestamp of the historical snapshot to be queried. More information can be found for the relevant endpoint in [the docs](https://the-odds-api.com/liveapi/guides/v4/) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-historical-timestamp) INVALID\_HISTORICAL\_TIMESTAMP --------------------------------------------------------------------------------------------------------------------------------- The `date` parameter must be in ISO8601 format, for example: `https://api.the-odds-api.com/v4/historical/sports/baseball_mlb/odds?apiKey=YOUR_API_KEY®ions=us&markets=h2h,spreads&date=2024-04-30T12:45:00Z` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-commence-time-from) INVALID\_COMMENCE\_TIME\_FROM ------------------------------------------------------------------------------------------------------------------------------ The `commenceTimeFrom` parameter must be in ISO8601 format, for example `2024-04-30T00:00:00Z` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-commence-time-to) INVALID\_COMMENCE\_TIME\_TO -------------------------------------------------------------------------------------------------------------------------- The `commenceTimeTo` parameter must be in ISO8601 format, for example `2024-04-30T23:59:59Z` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-commence-time-range) INVALID\_COMMENCE\_TIME\_RANGE -------------------------------------------------------------------------------------------------------------------------------- The `commenceTimeTo` parameter must be later than `commenceTimeFrom` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#historical-unavailable-on-free-usage-plan) HISTORICAL\_UNAVAILABLE\_ON\_FREE\_USAGE\_PLAN -------------------------------------------------------------------------------------------------------------------------------------------------------------- Historical data is only accessible on [paid usage plans](https://the-odds-api.com/#get-access) . Sample historical data can be [found here](https://the-odds-api.com/historical-odds-data/#sample-historical-odds-data) . [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-participant-id) INVALID\_PARTICIPANT\_ID --------------------------------------------------------------------------------------------------------------------- The participant id is invalid. It must start with `par_`, for example `par_01hqmkq6fceknv7cwebesgrx03` [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-include-links) INVALID\_INCLUDE\_LINKS ------------------------------------------------------------------------------------------------------------------- The `includeLinks` parameter determines whether links to bookmaker websites will be included in the API response. If `includeLinks` is provided, it must be either `true` or `false`. If `includeLinks` is not provided, it will default to `false`. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-include-sids) INVALID\_INCLUDE\_SIDS ----------------------------------------------------------------------------------------------------------------- The `includeSids` parameter determines whether source ids (sids) will be included in the API response. An example of a sid includes a bookmaker's id for an event, market or betting selection. If `includeSids` is provided, it must be either `true` or `false`. If `includeSids` is not provided, it will default to `false`. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-include-bet-limits) INVALID\_INCLUDE\_BET\_LIMITS ------------------------------------------------------------------------------------------------------------------------------ The `includeBetLimits` parameter determines whether a bookmaker's bet limits will be returned in each betting outcome in the API response. If `includeBetLimits` is provided, it must be either `true` or `false`. If `includeBetLimits` is not provided, it will default to `false`. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-include-multipliers) INVALID\_INCLUDE\_MULTIPLIERS ------------------------------------------------------------------------------------------------------------------------------- The `includeMultipliers` parameter determines whether a betting outcome's multiplier is included in the the API response. This is only applicable to DFS sites (`us_dfs` region). If `includeMultipliers` is provided, it must be either `true` or `false`. If `includeMultipliers` is not provided, it will default to `false`. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#invalid-include-rotation-numbers) INVALID\_INCLUDE\_ROTATION\_NUMBERS ========================================================================================================================================== The `includeRotationNumbers` parameter determines whether to include rotation numbers in the API response, if available. If `includeRotationNumbers` is provided, it must be either `true` or `false`. If `includeRotationNumbers` is not provided, it will default to `false`. [#](https://the-odds-api.com/liveapi/guides/v4/api-error-codes.html#historical-markets-unavailable-at-date) HISTORICAL\_MARKETS\_UNAVAILABLE\_AT\_DATE ------------------------------------------------------------------------------------------------------------------------------------------------------- One or more of the requested market keys are not available at the timestamp of the "date" parameter. The specific market keys will be listed in the API's error message response. --- # Support for CORS - The Odds API | The Odds API [#](https://the-odds-api.com/manage/cors.html#the-odds-api-support-for-cors) The Odds API support for CORS =========================================================================================================== The Odds API supports Cross-Origin Resource Sharing (CORS) from any origin. CORS requires HTTP or HTTPS as the origin URL schemes. Many browsers will block CORS if the request originates from a local file instead of a web server. For example, CORS will be blocked if the source URL starts with `file://`, such as `file://index.html`. More information can be [found here (opens new window)](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS/Errors/CORSRequestNotHttp) . To avoid CORS issues when developing locally, set up a local web server instead of opening HTML files directly from the file system. [#](https://the-odds-api.com/manage/cors.html#example-local-web-server-setup) Example Local Web Server Setup ============================================================================================================= As an example, [http-server (opens new window)](https://www.npmjs.com/package/http-server) is a popular local web server that can be installed with npm and set up as follows 1. Install: `npm install -g http-server` 2. Navigate to the project directory: `cd /path/to/your/project` 3. Start the local web server: `http-server` 4. Access files via HTTP Open your browser and go to `http://localhost:8080` (or replace the port with that specified by http-server). When serving files through a local web server, the origin will be `http://localhost` instead of `file://`, which will prevent CORS issues. --- # Update Credit Card | The Odds API [#](https://the-odds-api.com/payments/update-cc.html#updating-credit-card-details) Updating Credit Card Details ================================================================================================================ Billing information can be updated by [logging into your account](https://the-odds-api.com/account/) and clicking "Manage subscription" on the relevant subscription. If you have active subscriptions and are creating an account for the first time, be sure to use the same email address that was used for the subscriptions. For more information, [contact us](mailto:team@the-odds-api.com?subject=Update%20Billing%20Info) and we'll be happy to assist you. --- # Google Sheets Add-on Errors | The Odds API [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#google-sheets-add-on-errors) Google Sheets Add-on Errors ======================================================================================================================= This page lists common errors and solutions when using the [Sports Odds Plus add-on for Google Sheets (opens new window)](https://workspace.google.com/marketplace/app/sports_odds_plus/648207346109) . [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#authorization-is-required-to-perform-that-action) "Authorization is required to perform that action" ------------------------------------------------------------------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#issue) Issue After successfully installing and authenticating the [Sports Odds Plus add-on for Google Sheets (opens new window)](https://workspace.google.com/marketplace/app/sports_odds_plus/648207346109) , some users encounter the following error message: `Authorization is required to perform that action` ![Authorization is required to perform that action](https://the-odds-api.com/assets/img/add-on-authorization-required.png) ### [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#cause) Cause This issue is most likely seen if you are logged in to multiple Google accounts. The add-on becomes authenticated for your default account, but you are trying to use the add-on under a different account. This is a known bug with Google Sheets add-ons. Google is aware of the issue. More technical info on this bug the can be found on [Google's issue tracker (opens new window)](https://issuetracker.google.com/issues/69270374?pli=1) . ### [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#solutions) Solutions Any of these solutions might help: * Use the add-on in a private browser window (for example, Incognito mode in Chrome) * Use the add-on with a different browser, with only 1 signed in Google account * Log out from all accounts, and log in first to the account running the add-on [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#bandwidth-quota-exceeded) "Bandwidth Quota Exceeded" ------------------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#issue-2) Issue When querying the API in Apps Script using `UrlFetchApp`, some requests fail intermittently with an error similar to > Exception: Bandwidth quota exceeded: https://example.com/. Try reducing the rate of data transfer. This issue might also appear when using the add-on, which uses `UrlFetchApp` behind the scenes. ### [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#cause-2) Cause This appears to be due to a bug in Apps Script, first reported on September 11, 2025. Details can be found on [Google's Issue Tracker (opens new window)](https://issuetracker.google.com/issues/444196615?pli=1) ### [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#solutions-2) Solutions As of early October 2025, Google is investigating the cause but does not have more details. For the latest updates, see this issue on [Google's Issue Tracker (opens new window)](https://issuetracker.google.com/issues/444196615?pli=1) . [#](https://the-odds-api.com/manage/sheets-add-on-errors.html#other-issues) Other Issues ----------------------------------------------------------------------------------------- If you encounter other issues with the add-on, let us know at [team@the-odds-api.com](mailto:team@the-odds-api.com) --- # The Odds API - Bookmaker Deep Links | The Odds API [#](https://the-odds-api.com/releases/deep-links.html#bookmaker-deep-links) Bookmaker Deep Links ================================================================================================= 2024-September-22 Deep links to bookmaker websites are now available in the API. The [/odds](https://the-odds-api.com/liveapi/guides/v4/#get-odds) and [/events/odds](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) endpoints support the following parameters: * **includeLinks**   If "true", the response will include bookmaker links to events, markets, and betslips if available. Valid values are "true" or "false" * **includeSids**   If "true", the response will include source ids (bookmaker ids) for events, markets and outcomes if available. Valid values are "true" or "false". This field can be useful to construct your own links to handle variations in state or mobile app links. **Example Request** https://api.the-odds-api.com/v4/sports/baseball_mlb/odds?apiKey=YOUR_API_KEY&oddsFormat=american&markets=h2h®ions=us&includeLinks=true&includeSids=true **Example Response** [\ {\ "id": "c4b874cffbbc81ae41e455358e14453c",\ "sport_key": "baseball_mlb",\ "sport_title": "MLB",\ "commence_time": "2024-09-24T01:41:00Z",\ "home_team": "Arizona Diamondbacks",\ "away_team": "San Francisco Giants",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2024-09-23T02:26:27Z",\ "link": "https://sportsbook.fanduel.com/baseball/mlb/san-francisco-giants-%28h-birdsong%29-%40-arizona-diamondbacks-%28e-rodriguez%29-33617147",\ "sid": "33617147",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-09-23T02:26:27Z",\ "link": null,\ "sid": null,\ "outcomes": [\ {\ "name": "Arizona Diamondbacks",\ "price": -172,\ "link": "https://sportsbook.fanduel.com/addToBetslip?marketId=42.448600011&selectionId=29165",\ "sid": "29165"\ },\ {\ "name": "San Francisco Giants",\ "price": 144,\ "link": "https://sportsbook.fanduel.com/addToBetslip?marketId=42.448600011&selectionId=29178",\ "sid": "29178"\ }\ ]\ ...\ \ \ \ The availability of links will depend on the bookmaker. To determine which link to use, the following logic looks for the deepest available link, and falls back on successively shallower links.\ \ if (outcome.link) {\ link = outcome.link\ \ } else if (market.link) {\ link = market.link\ \ } else if (event.link) {\ link = event.link\ \ } else {\ // Fall back on the bookmaker's home page.\ // Bookmaker homepage links are not currently returned in the API and will need to be defined in your app.\ link = 'https://sportsbook.example.com'\ \ }\ \ \ [#](https://the-odds-api.com/releases/deep-links.html#bet-limits)\ Bet Limits\ =============================================================================\ \ Bet limits are being introduced in the API. These are the monetary amounts available for betting on a given odds selection, and are mostly applicable to betting exchanges. The currency will depend on the region of the betting exchange.\ \ Bet limits can be returned in the API by specifying the following parameter in either the [/odds](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ or [/events/odds](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ endpoints:\ \ * **includeBetLimits**   If "true", the response will include the bet limit of each betting option, mainly available for betting exchanges. Valid values are "true" or "false"\ \ **Example Request**\ \ https://api.the-odds-api.com/v4/sports/soccer_epl/odds?apiKey=YOUR_API_KEY&bookmakers=betfair_ex_uk&markets=h2h&includeBetLimits=true\ \ \ **Example Response**\ \ [\ {\ "id": "763235c932169620bd3d90dfef7d8403",\ "sport_key": "soccer_epl",\ "sport_title": "EPL",\ "commence_time": "2024-09-28T11:30:00Z",\ "home_team": "Newcastle United",\ "away_team": "Manchester City",\ "bookmakers": [\ {\ "key": "betfair_ex_uk",\ "title": "Betfair",\ "last_update": "2024-09-23T02:34:08Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-09-23T02:34:08Z",\ "outcomes": [\ {\ "name": "Manchester City",\ "price": 1.65,\ "bet_limit": 76\ },\ {\ "name": "Newcastle United",\ "price": 5.4,\ "bet_limit": 17\ },\ {\ "name": "Draw",\ "price": 4.7,\ "bet_limit": 105\ }\ ]\ },\ ...\ \ \ \ \ [#](https://the-odds-api.com/releases/deep-links.html#get-started)\ Get Started\ -------------------------------------------------------------------------------\ \ For more info on getting started, [see the docs](https://the-odds-api.com/liveapi/guides/4/)\ .\ \ To get started with a free API key, [see our plans](https://the-odds-api.com/#get-access)\ . --- # How to Cancel | The Odds API [#](https://the-odds-api.com/payments/how-to-cancel.html#cancelling-odds-api-subscriptions) Cancelling Odds API Subscriptions ============================================================================================================================== [#](https://the-odds-api.com/payments/how-to-cancel.html#cancelling) Cancelling -------------------------------------------------------------------------------- You can cancel your odds API subscription at any time on this page: [Cancel Subscription](https://the-odds-api.com/manage/cancel.html) When you cancel an odds API subscription, the subscription remains active until the next billing cycle. For example, if you sign up on January 1st, and cancel on January 15th, your subscription will remain active until February 1st. On February 1st (the next billing cycle), the subscription will end. We do not currently refund the unused portion of the subscription. [#](https://the-odds-api.com/payments/how-to-cancel.html#manage-a-subscription) Manage a Subscription ------------------------------------------------------------------------------------------------------ Odds API subscriptions can be managed by [logging into your account](https://the-odds-api.com/account/) and clicking "Manage subscription" on the relevant subscription. This includes updating billing info, upgrading or downgrading a subscription, and cancelling a subscription. If you have active subscriptions and are creating an account for the first time, be sure to use the same email address that was used for the subscriptions. --- # Privacy Policy | The Odds API [#](https://the-odds-api.com/privacy.html#privacy-policy) Privacy Policy ========================================================================= Effective date: August 22, 2018 THE ODDS API ("us", "we", or "our") operates the http://the-odds-api.com/ website, api product and add-ins (the "Service"). This page informs you of our policies regarding the collection, use, and disclosure of personal data when you use our Service and the choices you have associated with that data. We use your data to provide and improve the Service. By using the Service, you agree to the collection and use of information in accordance with this policy. Unless otherwise defined in this Privacy Policy, terms used in this Privacy Policy have the same meanings as in our Terms and Conditions, accessible from http://the-odds-api.com/ [#](https://the-odds-api.com/privacy.html#information-collection-and-use) Information Collection And Use --------------------------------------------------------------------------------------------------------- We collect several different types of information for various purposes to provide and improve our Service to you. ### [#](https://the-odds-api.com/privacy.html#types-of-data-collected) Types of Data Collected #### [#](https://the-odds-api.com/privacy.html#personal-data) Personal Data While using our Service, we may ask you to provide us with certain personally identifiable information that can be used to contact or identify you ("Personal Data"). Personally identifiable information may include, but is not limited to: * Email address * First name and last name * Cookies and Usage Data #### [#](https://the-odds-api.com/privacy.html#usage-data) Usage Data We may also collect information how the Service is accessed and used ("Usage Data"). This Usage Data may include information such as your computer's Internet Protocol address (e.g. IP address), browser type, browser version, the pages of our Service that you visit, the time and date of your visit, the time spent on those pages, unique device identifiers and other diagnostic data. #### [#](https://the-odds-api.com/privacy.html#tracking-cookies-data) Tracking & Cookies Data We use cookies and similar tracking technologies to track the activity on our Service and hold certain information. Cookies are files with small amount of data which may include an anonymous unique identifier. Cookies are sent to your browser from a website and stored on your device. Tracking technologies also used are beacons, tags, and scripts to collect and track information and to improve and analyze our Service. You can instruct your browser to refuse all cookies or to indicate when a cookie is being sent. However, if you do not accept cookies, you may not be able to use some portions of our Service. Examples of Cookies we do and do not use: * **Session Cookies.** We use Session Cookies to operate our Service. * **Preference Cookies.** We do **not** use Preference Cookies to remember your preferences and various settings. * **Security Cookies.** We use Security Cookies for security purposes. [#](https://the-odds-api.com/privacy.html#use-of-data) Use of Data ------------------------------------------------------------------- THE ODDS API uses the collected data for various purposes: * To provide and maintain the Service * To notify you about changes to our Service * To allow you to participate in interactive features of our Service when you choose to do so * To provide customer care and support * To provide analysis or valuable information so that we can improve the Service * To monitor the usage of the Service * To detect, prevent and address technical issues [#](https://the-odds-api.com/privacy.html#transfer-of-data) Transfer Of Data ----------------------------------------------------------------------------- Your information, including Personal Data, may be transferred to — and maintained on — computers located outside of your state, province, country or other governmental jurisdiction where the data protection laws may differ than those from your jurisdiction. If you are located outside Australia and choose to provide information to us, please note that we transfer the data, including Personal Data, to Australia and process it there. Your consent to this Privacy Policy followed by your submission of such information represents your agreement to that transfer. THE ODDS API will take all steps reasonably necessary to ensure that your data is treated securely and in accordance with this Privacy Policy and no transfer of your Personal Data will take place to an organization or a country unless there are adequate controls in place including the security of your data and other personal information. [#](https://the-odds-api.com/privacy.html#disclosure-of-data) Disclosure Of Data --------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/privacy.html#legal-requirements) Legal Requirements THE ODDS API may disclose your Personal Data in the good faith belief that such action is necessary to: * To comply with a legal obligation * To protect and defend the rights or property of THE ODDS API * To prevent or investigate possible wrongdoing in connection with the Service * To protect the personal safety of users of the Service or the public * To protect against legal liability [#](https://the-odds-api.com/privacy.html#security-of-data) Security Of Data ----------------------------------------------------------------------------- The security of your data is important to us, but remember that no method of transmission over the Internet, or method of electronic storage is 100% secure. While we strive to use commercially acceptable means to protect your Personal Data, we cannot guarantee its absolute security. [#](https://the-odds-api.com/privacy.html#service-providers) Service Providers ------------------------------------------------------------------------------- We may employ third party companies and individuals to facilitate our Service ("Service Providers"), to provide the Service on our behalf, to perform Service-related services or to assist us in analyzing how our Service is used. These third parties have access to your Personal Data only to perform these tasks on our behalf and are obligated not to disclose or use it for any other purpose. ### [#](https://the-odds-api.com/privacy.html#analytics) Analytics We use third-party Service Providers to monitor and analyze the use of our Service. * **Google Analytics** is a web analytics service offered by Google that tracks and reports website traffic. Google uses the data collected to track and monitor the use of our Service. This data is shared with other Google services. Google may use the collected data to contextualize and personalize the ads of its own advertising network. You can opt-out of having made your activity on the Service available to Google Analytics by installing the Google Analytics opt-out browser add-on. The add-on prevents the Google Analytics JavaScript (ga.js, analytics.js, and dc.js) from sharing information with Google Analytics about visits activity. For more information on the privacy practices of Google, please visit the Google Privacy & Terms web page: [https://policies.google.com/privacy?hl=en](https://policies.google.com/privacy?hl=en) [#](https://the-odds-api.com/privacy.html#links-to-other-sites) Links To Other Sites ------------------------------------------------------------------------------------- Our Service may contain links to other sites that are not operated by us. If you click on a third party link, you will be directed to that third party's site. We strongly advise you to review the Privacy Policy of every site you visit. We have no control over and assume no responsibility for the content, privacy policies or practices of any third party sites or services. [#](https://the-odds-api.com/privacy.html#children-s-privacy) Children's Privacy --------------------------------------------------------------------------------- Our Service does not address anyone under the age of 18 ("Children"). We do not knowingly collect personally identifiable information from anyone under the age of 18. If you are a parent or guardian and you are aware that your Children has provided us with Personal Data, please contact us. If we become aware that we have collected Personal Data from children without verification of parental consent, we take steps to remove that information from our servers. [#](https://the-odds-api.com/privacy.html#changes-to-this-privacy-policy) Changes To This Privacy Policy --------------------------------------------------------------------------------------------------------- We may update our Privacy Policy from time to time. We will notify you of any changes by posting the new Privacy Policy on this page. We will let you know via email and/or a prominent notice on our Service (for example, a Twitter post), prior to the change becoming effective and update the "effective date" at the top of this Privacy Policy. You are advised to review this Privacy Policy periodically for any changes. Changes to this Privacy Policy are effective when they are posted on this page. [#](https://the-odds-api.com/privacy.html#data-policy-for-google-sheets-add-on) Data Policy for Google Sheets Add-on --------------------------------------------------------------------------------------------------------------------- Part of our Service offering includes the [Google Sheets Add-on](https://the-odds-api.com/features/spreadsheets.html) . The Google Sheets Add-on does not collect any personal information about the user who installed it. The Google Sheets Add-on does not read any data from the document in which it is installed, with the exception of input parameter fields from the add-on itself. [#](https://the-odds-api.com/privacy.html#contact-us) Contact Us ----------------------------------------------------------------- If you have any questions about this Privacy Policy, please contact us: * By email: team@the-odds-api.com --- # Odds API Game Id | The Odds API [#](https://the-odds-api.com/releases/game-id.html#game-id) Game Id ==================================================================== 10-Mar-2021 Unique game ids are now included in the API response for API version 3. A unique game id is a string of 32 characters, constructed from a combination of * The sport key * The participants in the game * The commence time of the game Unique ids will tolerate changes in commence time up to 8 hours of their _originally listed_ commence time. If a game is delayed or brought forward more than 8 hours, it will be issued a new id. For outrights events (such as golf), this threshold is 1 week. For example, a game between teams A and B at `2021-03-01T00:00:00Z` might have a unique game id `5cc7c4e08fb03088252f8e0b046bb761`. If the game is delayed 2 hours (commence time changes to `2021-03-01T00:02:00Z`), the id will remain unchanged. If the game is postponed until the following day (`2021-03-02T00:00:00Z`), it will be issued a new id. [#](https://the-odds-api.com/releases/game-id.html#get-started) Get Started ---------------------------------------------------------------------------- For more info on getting started, [see the docs](https://the-odds-api.com/liveapi/guides/4/) . To get started with a free API key, [see our plans](https://the-odds-api.com/#get-access) . --- # Odds API Outrights & Futures | The Odds API [#](https://the-odds-api.com/releases/outrights.html#outrights-futures-markets) Outrights / Futures Markets ============================================================================================================ Update This update only applies to version 3 of the API. Outrights are available by default in later versions. 07-Jul-2020 Outrights (futures) markets are now supported in version 3 of The Odds API, starting off with Super Bowl Winner, Golf Majors and Next US President. There are 2 things to know in order to access outrights odds. ### [#](https://the-odds-api.com/releases/outrights.html#_1-include-outrights-param-when-getting-sports) 1. Include `outrights` param when getting sports Include the `outrights` GET param (`&outrights=true`), when requesting the `/v3/sports` endpoint. The response will include sports and events with outrights in addition to sports with regular season events. To see if a sport has outrights, check its `has_outrights` key. For example: GET /v3/sports/?apiKey={apiKey}&outrights=true { "key": "americanfootball_nfl_super_bowl_winner", "active": true, "group": "American Football", "details": "Super Bowl Winner 2020/2021", "title": "NFL Super Bowl Winner", "has_outrights": true }, { "key": "americanfootball_nfl", "active": true, "group": "American Football", "details": "US Football", "title": "NFL", "has_outrights": false }, ... ### [#](https://the-odds-api.com/releases/outrights.html#_2-include-mkt-outrights-or-exclude-mkt-when-getting-odds) 2. Include `mkt=outrights` or exclude `mkt` when getting odds Include the GET param `mkt=outrights` when requesting the `/v3/odds` endpoint for an outright sport. You can also exclude the `mkt` param entirely to have it default to outrights. For example: GET /v3/odds/?apiKey={apiKey}®ion=us&sport=americanfootball_nfl_super_bowl_winner&mkt=outrights "data": [\ {\ "sport_key": "americanfootball_nfl_super_bowl_winner",\ "sport_nice": "Super Bowl Winner",\ "commence_time": 1612738800,\ "sites": [\ {\ "site_key": "betfair",\ "site_nice": "Betfair",\ "last_update": 1585732898,\ "odds": {\ "outrights": [\ {\ "name": "Kansas City Chiefs",\ "price": 7.4\ },\ {\ "name": "Baltimore Ravens",\ "price": 8.4\ },\ ...\ \ \ \ Update Interval\ \ Outrights are usually less dynamic than other markets, so their update interval is up to 30 mins pre-match, and up to 1 minute as games go live.\ \ Schema Differences\ \ The outrights schema has some differences to the schema for regular season games:\ \ * Missing `teams` key\ * Missing `home_team` key\ \ Due to these differences, the visibility of outrights in version 3 was made optional and disabled by default in the `/sports` endpoint. This was to ensure existing API integrations were unaffected.\ \ \ \ [#](https://the-odds-api.com/releases/outrights.html#get-started)\ Get Started\ ------------------------------------------------------------------------------\ \ For more info on getting started, [see the docs](https://the-odds-api.com/liveapi/guides/v3/)\ .\ \ To get started with a free API key, [see our plans](https://the-odds-api.com/#get-access)\ . --- # Bets API | The Odds API [#](https://the-odds-api.com/sports-odds-data/bets-api.html#bets-api) Bets API =============================================================================== The Odds API offers a betting API that returns near real-time betting odds for several bookmakers and several sports. Get started with a [free API key →](https://the-odds-api.com/#get-access) [#](https://the-odds-api.com/sports-odds-data/bets-api.html#bookmakers-api) Bookmakers API ------------------------------------------------------------------------------------------- The bets API delivers odds from several bookmakers around the world. * **US Bookmakers**: Draftkings odds, FanDuel odds, Unibet odds, William Hill odds, BetMGM odds, BetRivers odds and more * **UK Bookmakers**: William Hill odds, Ladbrokes odds, Betfair odds, UniBet odds, Paddy Power odds, BetFred odds, Matchbook odds and more * **EU Bookmakers**: William Hill odds, Betfair odds, 1xBet odds, Betclic odds, Pinnacle odds and more * **AU Bookmakers**: Sportsbet odds, TAB odds, Unibet odds, BetFair odds, Ladbrokes odds and more See the full [list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) for details [#](https://the-odds-api.com/sports-odds-data/bets-api.html#api-sports) API Sports ----------------------------------------------------------------------------------- The Odds API delivers betting odds for several sports including: * **Football odds data:** NFL, College Football (NCAA), Aussie Rules (AFL) * **Soccer odds data:** EPL, FA Cup, German Bundesliga, UEFA Europa & Champions Leagues, Italian Serie A, Spanish La Liga, Campeonato Brasileiro Série A, A-league and much more * **Basketball odds data:** NBA, US College Basketball (NCAA), Euroleague * **Baseball odds data:** MLB, MiLB, KBO, NPB * **Ice hockey odds data:** NHL, SHL, HockeyAllsvenskan and more * **Cricket odds data:** Test matches, IPL, Big Bash and more * **Rugby league odds data:** Aussie NRL * **Golf odds data:** Masters Tournament, PGA Championship, US Open, The Open Championship * **Tennis odds data:** All Grand Slams and more * **Politics odds data:** Next US President odds * **And more** [#](https://the-odds-api.com/sports-odds-data/bets-api.html#api-markets) API Markets ------------------------------------------------------------------------------------- The bets API offers odds for **moneyline**, **points spreads** and **over/under** (totals) markets, as well as select futures markets including NFL Superbowl Winner and Next US President. [#](https://the-odds-api.com/sports-odds-data/bets-api.html#api-latency) API Latency ------------------------------------------------------------------------------------- Odds are updated with a maximum latency of 2 minutes for pre-match games, and maximum 40 second latency when games are in-play. Learn more about [update intervals](https://the-odds-api.com/sports-odds-data/update-intervals.html) . [#](https://the-odds-api.com/sports-odds-data/bets-api.html#bets-api-format) Bets API Format --------------------------------------------------------------------------------------------- The bets API returns data in an easy to use JSON format, which helps make implementation seamless and low cost. The bets API offers odds in both decimal and American formats. // Sample showing a subset of The Odds API response (version 3), // returning odds for NFL games, moneyline (head-to-head) markets, // for bookmakers in the US region. Odds are in American format. "sport_key": "americanfootball_nfl", "sport_nice": "NFL", "teams": ["Chicago Bears", "Tampa Bay Buccaneers"], "home_team": "Chicago Bears", "commence_time": "2020-10-09T00:20:00Z", "sites": [\ {\ "site_key": "fanduel",\ "site_nice": "FanDuel",\ "last_update": "2020-10-06T08:00:04Z",\ "odds": {"h2h": [198,-240]}\ },\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": "2020-10-06T07:57:36Z",\ "odds": {"h2h": [205,-238]}\ },\ {\ "site_key": "betrivers",\ "site_nice": "BetRivers",\ "last_update": "2020-10-06T08:00:41Z",\ "odds": {"h2h": [205,-240]}\ },\ {\ "site_key": "draftkings",\ "site_nice": "DraftKings",\ "last_update": "2020-10-06T08:00:22Z",\ "odds": {"h2h": [205,-240]}\ },\ {\ "site_key": "betmgm",\ "site_nice": "BetMGM",\ "last_update": "2020-10-06T08:00:54Z",\ "odds": {"h2h": [205,-250]}\ },\ \ ...\ \ \ See [the API docs](https://the-odds-api.com/liveapi/guides/v4/)\ for more details\ \ [#](https://the-odds-api.com/sports-odds-data/bets-api.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ \ \ To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key\ \ Get a Free API Key →\ \ \ \ To get started with the **JSON API**, see\ \ * [Odds API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html)\ \ \ To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the [Odds Widget](https://the-odds-api.com/widget/)\ \ To get sports odds in **Excel** or **Google Sheets** at the click of a button (no coding needed), see\ \ * [Odds in Excel](https://the-odds-api.com/features/excel.html)\ \ * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # Sports Odds Data | The Odds API [#](https://the-odds-api.com/sports-odds-data/#sports-odds-data) Sports Odds Data ================================================================================== Get access to sports odds data from over 50 different bookmakers. We offer current odds data for a wide range of sports including\* * NFL Odds * NBA Odds * EPL Odds * AFL Odds * Tennis Odds * and [**lots more**](https://the-odds-api.com/sports-odds-data/sports-apis.html) Discover the bookmakers, sports and markets we cover by getting a [**free** API key](https://the-odds-api.com/#get-access) [#](https://the-odds-api.com/sports-odds-data/#how-to-access-odds-data) How to access odds data ------------------------------------------------------------------------------------------------ After signing up for a free API key, access odds data in a number of different ways. ### [#](https://the-odds-api.com/sports-odds-data/#sports-odds-data-in-excel-and-google-sheets) Sports Odds Data in Excel and Google Sheets Get sports odds data in Excel or Google sheets at the click of a button. Check out out free add-ons for Excel and Google Sheets: * [Odds data in Excel](https://the-odds-api.com/features/excel.html) * [Odds data in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) ![Sports Odds in Sheets](https://the-odds-api.com/assets/img/sports-odds-in-excel.jpg) ### [#](https://the-odds-api.com/sports-odds-data/#sports-odds-data-json-api) Sports Odds Data JSON API For developers, our API delivers current sports odds in a simple JSON structure. To see sports odds for live and upcoming games, specify the sport you want, the region of bookmakers (us, us2, uk, eu, au), and your [API key](https://the-odds-api.com/) in a simple GET request. For more details, see the [API Quickstart Guide](https://the-odds-api.com/liveapi/guides/v4/) . Check out our [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) to help you get started. **Example Request** GET https://api.the-odds-api.com/v4/soccer_epl/odds?regions=uk&apiKey=YOUR_API_KEY **Example Response** { "id": "0ba40aad3c918f52363117a71f5de8e8", "sport_key": "soccer_epl", "sport_title": "EPL", "commence_time": "2023-04-01T11:30:00Z", "home_team": "Manchester City", "away_team": "Liverpool", "bookmakers": [\ {\ "key": "williamhill",\ "title": "William Hill",\ "last_update": "2023-03-26T23:04:06Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-03-26T23:04:06Z",\ "outcomes": [\ { "name": "Liverpool", "price": 5.5 },\ { "name": "Manchester City", "price": 1.57 },\ { "name": "Draw", "price": 4.0 }\ ]\ }\ ]\ },\ ...\ \ Discover more about the bookmakers, sports and markets that we cover with [get a free API key →](https://the-odds-api.com/)\ \ \ \ * * * --- # Showcase - The Odds API | The Odds API SHOWCASE ![Coming soon](https://the-odds-api.com/assets/img/comingsoon.svg) A showcase of selected projects that use The Odds API. [Submit Your Project (opens new window)](https://docs.google.com/forms/d/e/1FAIpQLSdD_wucnKmrg2Et8D8z7cBEc8QspkAev9Q8GFISdSi5gvQvmQ/viewform) --- # The Odds API 404 === > That's a Four-Oh-Four. [Take me home.](https://the-odds-api.com/) --- # The Odds API - Rotation Numbers | The Odds API [#](https://the-odds-api.com/releases/rotation-numbers.html#rotation-numbers) Rotation Numbers =============================================================================================== 2025-November-04 Rotation numbers are now available in The Odds API. Home team and away team rotation numbers are returned in the API response by providing the `includeRotationNumbers=true` parameter when using the following endpoints: * [Odds](https://the-odds-api.com/liveapi/guides/v4/#get-odds) * [Events](https://the-odds-api.com/liveapi/guides/v4/#get-events) * [Event-odds](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) * [Historical odds](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds) * [Historical events](https://the-odds-api.com/liveapi/guides/v4/#get-historical-events) * [Historical event-odds](https://the-odds-api.com/liveapi/guides/v4/#get-historical-event-odds) [#](https://the-odds-api.com/releases/rotation-numbers.html#availability) Availability --------------------------------------------------------------------------------------- Rotation numbers are populated on a best-effort basis and can be null in some situations. * Rotation numbers can be null when new games first appear in the API. We use a variety of sources for game and rotation number information, and game listings on these sources won't always be in sync. * Rotation numbers can be null for games listed far out. The API can return games that are months away if sportsbooks have odds available. These games can have null rotation numbers until they are closer to the game date. * Rotation numbers are only available for the top US sports, including: NFL, NCAAF, MLB, NBA, NCAAB, WNBA and NHL. [#](https://the-odds-api.com/releases/rotation-numbers.html#examples) Examples ------------------------------------------------------------------------------- **Example Request** https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events?apiKey={apiKey}&includeRotationNumbers=true **Example Response** [\ {\ "id": "13bdffda97e8fb13179fe3f2f69d66f8",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2025-11-07T01:15:00Z",\ "home_team": "Denver Broncos",\ "away_team": "Las Vegas Raiders",\ "home_rotation": 110,\ "away_rotation": 109\ },\ {\ "id": "42473c1ddf8f424069ff3f264dd8dca4",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2025-11-09T14:30:00Z",\ "home_team": "Indianapolis Colts",\ "away_team": "Atlanta Falcons",\ "home_rotation": 252,\ "away_rotation": 251\ },\ ...\ \ \ \ \ [#](https://the-odds-api.com/releases/rotation-numbers.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ For more info on getting started, [see the docs](https://the-odds-api.com/liveapi/guides/4/)\ .\ \ To get started with a free API key, [see our plans](https://the-odds-api.com/#get-access)\ . --- # List of API Betting Markets | The Odds API [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#betting-markets) Betting Markets ==================================================================================================== The Odds API covers the betting markets listed below. [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#featured-betting-markets) Featured Betting Markets ---------------------------------------------------------------------------------------------------------------------- These are the most common markets that are featured by bookmakers. Terminology for betting markets can vary by country, sport and even amongst bookmakers. We aim to simplify this by defining the following markets | Market Key
(use in the API) | Market Names | Description | | --- | --- | --- | | h2h | Head to head, Moneyline | Bet on the winning team or player of a game (includes the draw for soccer) | | spreads | Points spread, Handicap | The spreads market as featured by a bookmaker. Bet on the winning team after a points handicap has been applied to each team | | totals | Total points/goals, Over/Under | The totals market as featured by a bookmaker. Bet on the total score of the game being above or below a threshold | | outrights | Outrights, Futures | Bet on a final outcome of a tournament or competition | | h2h\_lay | Same as h2h | Bet against a h2h outcome. This market is only applicable to betting exchanges | | outrights\_lay | Same as outrights | Bet against an outrights outcome. This market is only applicable to betting exchanges | `spreads` and `totals` markets are mainly available for US sports and bookmakers at this time. For descriptions of these markets, see [examples of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html) . [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#additional-markets) Additional Markets ---------------------------------------------------------------------------------------------------------- Starting in 2023, more markets are becoming available in the API. Additional markets are currently limited to US sports and selected bookmakers, however coverage is expanding. Additional markets update at 1 minute intervals. Due to the growing size of the API response, additional markets need to be accessed one event at a time using the new [`/events/{eventId}/odds` endpoint](https://the-odds-api.com/liveapi/guides/v4/#endpoint-5) . | Market Key
(use in the API) | Market Name | Description | | --- | --- | --- | | alternate\_spreads | Alternate Spreads (handicap) | All available point spread outcomes for each team | | alternate\_totals | Alternate Totals (Over/Under) | All available over/under outcomes | | btts | Both Teams to Score | Odds that both teams will score during the game. Outcomes are "Yes" or "No". Available for soccer. | | draw\_no\_bet | Draw No Bet | Odds for the match winner, excluding the draw outcome. A draw will result in a returned bet. Available for soccer | | h2h\_3\_way | Head to head / Moneyline 3 way | Match winner including draw | | team\_totals | Team Totals | Featured team totals (Over/Under) | | alternate\_team\_totals | Alternate Team Totals | All available team totals (Over/Under) | Suggest new markets We are exploring new markets to add. [Suggest new markets. (opens new window)](https://docs.google.com/forms/d/e/1FAIpQLSfxW8riJU92gSxT3-pEaYCTx4yvB7J3hHmV6w5ZzqYLd9R11w/viewform?embedded=true&usp=pp_url&entry.454625652=New+betting+markets) . For updates on new markets and other features, check out our [Twitter page (opens new window)](https://twitter.com/The_Odds_API) . [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#game-period-markets) Game Period Markets ------------------------------------------------------------------------------------------------------------ Game period markets depend on the sport, and can include quarter time odds, half time odds, period odds, and innings odds. | Market Key
(use in the API) | Market Name | Note | | --- | --- | --- | | h2h\_q1 | Moneyline 1st Quarter | | | h2h\_q2 | Moneyline 2nd Quarter | | | h2h\_q3 | Moneyline 3rd Quarter | | | h2h\_q4 | Moneyline 4th Quarter | | | h2h\_h1 | Moneyline 1st Half | | | h2h\_h2 | Moneyline 2nd Half | | | h2h\_p1 | Moneyline 1st Period | Valid for ice hockey | | h2h\_p2 | Moneyline 2nd Period | Valid for ice hockey | | h2h\_p3 | Moneyline 3rd Period | Valid for ice hockey | | h2h\_3\_way\_q1 | 1st Quarter 3 Way Result | | | h2h\_3\_way\_q2 | 2nd Quarter 3 Way Result | | | h2h\_3\_way\_q3 | 3rd Quarter 3 Way Result | | | h2h\_3\_way\_q4 | 4th Quarter 3 Way Result | | | h2h\_3\_way\_h1 | 1st Half 3 Way Result | | | h2h\_3\_way\_h2 | 2nd Half 3 Way Result | | | h2h\_3\_way\_p1 | 1st Period 3 Way Result | Valid for ice hockey | | h2h\_3\_way\_p2 | 2nd Period 3 Way Result | Valid for ice hockey | | h2h\_3\_way\_p3 | 3rd Period 3 Way Result | Valid for ice hockey | | h2h\_1st\_1\_innings | Moneyline 1st inning | Valid for baseball | | h2h\_1st\_3\_innings | Moneyline 1st 3 innings | Valid for baseball | | h2h\_1st\_5\_innings | Moneyline 1st 5 innings | Valid for baseball | | h2h\_1st\_7\_innings | Moneyline 1st 7 innings | Valid for baseball | | h2h\_3\_way\_1st\_1\_innings | 3-way moneyline 1st inning | Valid for baseball | | h2h\_3\_way\_1st\_3\_innings | 3-way moneyline 1st 3 innings | Valid for baseball | | h2h\_3\_way\_1st\_5\_innings | 3-way moneyline 1st 5 innings | Valid for baseball | | h2h\_3\_way\_1st\_7\_innings | 3-way moneyline 1st 7 innings | Valid for baseball | | spreads\_q1 | Spreads 1st Quarter | | | spreads\_q2 | Spreads 2nd Quarter | | | spreads\_q3 | Spreads 3rd Quarter | | | spreads\_q4 | Spreads 4th Quarter | | | spreads\_h1 | Spreads 1st Half | | | spreads\_h2 | Spreads 2nd Half | | | spreads\_p1 | Spreads 1st Period | Valid for ice hockey | | spreads\_p2 | Spreads 2nd Period | Valid for ice hockey | | spreads\_p3 | Spreads 3rd Period | Valid for ice hockey | | spreads\_1st\_1\_innings | Spreads 1st inning | Valid for baseball | | spreads\_1st\_3\_innings | Spreads 1st 3 innings | Valid for baseball | | spreads\_1st\_5\_innings | Spreads 1st 5 innings | Valid for baseball | | spreads\_1st\_7\_innings | Spreads 1st 7 innings | Valid for baseball | | alternate\_spreads\_1st\_1\_innings | Alternate spreads 1st inning | Valid for baseball | | alternate\_spreads\_1st\_3\_innings | Alternate spreads 1st 3 innings | Valid for baseball | | alternate\_spreads\_1st\_5\_innings | Alternate spreads 1st 5 innings | Valid for baseball | | alternate\_spreads\_1st\_7\_innings | Alternate spreads 1st 7 innings | Valid for baseball | | alternate\_spreads\_q1 | Alternate spreads 1st Quarter | | | alternate\_spreads\_q2 | Alternate spreads 2nd Quarter | | | alternate\_spreads\_q3 | Alternate spreads 3rd Quarter | | | alternate\_spreads\_q4 | Alternate spreads 4th Quarter | | | alternate\_spreads\_h1 | Alternate spreads 1st Half | | | alternate\_spreads\_h2 | Alternate spreads 2nd Half | | | alternate\_spreads\_p1 | Alternate spreads 1st Period | Valid for ice hockey | | alternate\_spreads\_p2 | Alternate spreads 2nd Period | Valid for ice hockey | | alternate\_spreads\_p3 | Alternate spreads 3rd Period | Valid for ice hockey | | totals\_q1 | Over/under 1st Quarter | | | totals\_q2 | Over/under 2nd Quarter | | | totals\_q3 | Over/under 3rd Quarter | | | totals\_q4 | Over/under 4th Quarter | | | totals\_h1 | Over/under 1st Half | | | totals\_h2 | Over/under 2nd Half | | | totals\_p1 | Over/under 1st Period | Valid for ice hockey | | totals\_p2 | Over/under 2nd Period | Valid for ice hockey | | totals\_p3 | Over/under 3rd Period | Valid for ice hockey | | totals\_1st\_1\_innings | Over/under 1st inning | Valid for baseball | | totals\_1st\_3\_innings | Over/under 1st 3 innings | Valid for baseball | | totals\_1st\_5\_innings | Over/under 1st 5 innings | Valid for baseball | | totals\_1st\_7\_innings | Over/under 1st 7 innings | Valid for baseball | | alternate\_totals\_1st\_1\_innings | Alternate over/under 1st inning | Valid for baseball | | alternate\_totals\_1st\_3\_innings | Alternate over/under 1st 3 innings | Valid for baseball | | alternate\_totals\_1st\_5\_innings | Alternate over/under 1st 5 innings | Valid for baseball | | alternate\_totals\_1st\_7\_innings | Alternate over/under 1st 7 innings | Valid for baseball | | alternate\_totals\_q1 | Alternate totals 1st Quarter | | | alternate\_totals\_q2 | Alternate totals 2nd Quarter | | | alternate\_totals\_q3 | Alternate totals 3rd Quarter | | | alternate\_totals\_q4 | Alternate totals 4th Quarter | | | alternate\_totals\_h1 | Alternate totals 1st Half | | | alternate\_totals\_h2 | Alternate totals 2nd Half | | | alternate\_totals\_p1 | Alternate totals 1st Period | Valid for ice hockey | | alternate\_totals\_p2 | Alternate totals 2nd Period | Valid for ice hockey | | alternate\_totals\_p3 | Alternate totals 3rd Period | Valid for ice hockey | | team\_totals\_h1 | Team Totals 1st Half | | | team\_totals\_h2 | Team Totals 2nd Half | | | team\_totals\_q1 | Team Totals 1st Quarter | | | team\_totals\_q2 | Team Totals 2nd Quarter | | | team\_totals\_q3 | Team Totals 3rd Quarter | | | team\_totals\_q4 | Team Totals 4th Quarter | | | team\_totals\_p1 | Team Totals 1st Period | Valid for ice hockey | | team\_totals\_p2 | Team Totals 2nd Period | Valid for ice hockey | | team\_totals\_p3 | Team Totals 3rd Period | Valid for ice hockey | | alternate\_team\_totals\_h1 | Alternate Team Totals 1st Half | | | alternate\_team\_totals\_h2 | Alternate Team Totals 2nd Half | | | alternate\_team\_totals\_q1 | Alternate Team Totals 1st Quarter | | | alternate\_team\_totals\_q2 | Alternate Team Totals 2nd Quarter | | | alternate\_team\_totals\_q3 | Alternate Team Totals 3rd Quarter | | | alternate\_team\_totals\_q4 | Alternate Team Totals 4th Quarter | | | alternate\_team\_totals\_p1 | Alternate Team Totals 1st Period | Valid for ice hockey | | alternate\_team\_totals\_p2 | Alternate Team Totals 2nd Period | Valid for ice hockey | | alternate\_team\_totals\_p3 | Alternate Team Totals 3rd Period | Valid for ice hockey | [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#player-props-api-markets) Player Props API Markets ---------------------------------------------------------------------------------------------------------------------- Coverage of player props is mainly limited to US sports and US bookmakers at this time. Player props can be accessed one event at a time using the [`/events/{eventId}/odds` endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#nfl-ncaaf-cfl-player-props-api) NFL, NCAAF, CFL Player Props API | Market Key
(use in the API) | Market Name | | --- | --- | | player\_assists | Assists (Over/Under) | | player\_defensive\_interceptions | Defensive Interceptions (Over/Under) | | player\_field\_goals | Field Goals (Over/Under) | | player\_kicking\_points | Kicking Points (Over/Under) | | player\_pass\_attempts | Pass Attempts (Over/Under) | | player\_pass\_completions | Pass Completions (Over/Under) | | player\_pass\_interceptions | Pass Intercepts (Over/Under) | | player\_pass\_longest\_completion | Longest Pass Completion (Over/Under) | | player\_pass\_rush\_yds | Pass + Rush Yards (Over/Under) | | player\_pass\_rush\_reception\_tds | Pass + Rush + Reception Touchdowns (Over/Under) | | player\_pass\_rush\_reception\_yds | Pass + Rush + Reception Yards (Over/Under) | | player\_pass\_tds | Pass Touchdowns (Over/Under) | | player\_pass\_yds | Pass Yards (Over/Under) | | player\_pass\_yds\_q1 | 1st Quarter Pass Yards (Over/Under) | | player\_pats | Points After Touchdown (Over/Under) | | player\_receptions | Receptions (Over/Under) | | player\_reception\_longest | Longest Reception (Over/Under) | | player\_reception\_tds | Reception Touchdowns (Over/Under) | | player\_reception\_yds | Reception Yards (Over/Under) | | player\_rush\_attempts | Rush Attempts (Over/Under) | | player\_rush\_longest | Longest Rush (Over/Under) | | player\_rush\_reception\_tds | Rush + Reception Touchdowns (Over/Under) | | player\_rush\_reception\_yds | Rush + Reception Yards (Over/Under) | | player\_rush\_tds | Rush Touchdowns (Over/Under) | | player\_rush\_yds | Rush Yards (Over/Under) | | player\_sacks | Sacks (Over/Under) | | player\_solo\_tackles | Solo Tackles (Over/Under) | | player\_tackles\_assists | Tackles + Assists (Over/Under) | | player\_tds\_over | Touchdowns (Over only) | | player\_1st\_td | 1st Touchdown Scorer (Yes/No) | | player\_anytime\_td | Anytime Touchdown Scorer (Yes/No) | | player\_last\_td | Last Touchdown Scorer (Yes/No) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#alternate-nfl-player-props-api) Alternate NFL Player Props API | Market Key
(use in the API) | Market Name | | --- | --- | | player\_assists\_alternate | Alternate Assists (Over/Under) | | player\_field\_goals\_alternate | Alternate Field Goals (Over/Under) | | player\_kicking\_points\_alternate | Alternate Kicking Points (Over/Under) | | player\_pass\_attempts\_alternate | Alternate Pass Attempts (Over/Under) | | player\_pass\_completions\_alternate | Alternate Pass Completions (Over/Under) | | player\_pass\_interceptions\_alternate | Alternate Pass Interceptions (Over/Under) | | player\_pass\_longest\_completion\_alternate | Alternate Longest Pass Completion (Over/Under) | | player\_pass\_rush\_yds\_alternate | Alternate Pass + Rush Yards (Over/Under) | | player\_pass\_rush\_reception\_tds\_alternate | Alternate Pass + Rush + Reception Touchdowns (Over/Under) | | player\_pass\_rush\_reception\_yds\_alternate | Alternate Pass + Rush + Reception Yards (Over/Under) | | player\_pass\_tds\_alternate | Alternate Pass Touchdowns (Over/Under) | | player\_pass\_yds\_alternate | Alternate Pass Yards (Over/Under) | | player\_pats\_alternate | Alternate Points After Touchdown (Over/Under) | | player\_receptions\_alternate | Alternate Receptions (Over/Under) | | player\_reception\_longest\_alternate | Alternate Longest Reception (Over/Under) | | player\_reception\_tds\_alternate | Alternate Reception Touchdowns (Over/Under) | | player\_reception\_yds\_alternate | Alternate Reception Yards (Over/Under) | | player\_rush\_attempts\_alternate | Alternate Rush Attempts (Over/Under) | | player\_rush\_longest\_alternate | Alternate Longest Rush (Over/Under) | | player\_rush\_reception\_tds\_alternate | Alternate Rush + Reception Touchdowns (Over/Under) | | player\_rush\_reception\_yds\_alternate | Alternate Rush + Reception Yards (Over/Under) | | player\_rush\_tds\_alternate | Alternate Rush Touchdowns (Over/Under) | | player\_rush\_yds\_alternate | Alternate Rush Yards (Over/Under) | | player\_sacks\_alternate | Alternate Sacks (Over/Under) | | player\_solo\_tackles\_alternate | Alternate Solo Tackles (Over/Under) | | player\_tackles\_assists\_alternate | Alternate Tackles + Assists (Over/Under) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#nba-ncaab-wnba-player-props-api) NBA, NCAAB, WNBA Player Props API | Market Key
(use in the API) | Market Name | | --- | --- | | player\_points | Points (Over/Under) | | player\_points\_q1 | 1st Quarter Points (Over/Under) | | player\_rebounds | Rebounds (Over/Under) | | player\_rebounds\_q1 | 1st Quarter Rebounds (Over/Under) | | player\_assists | Assists (Over/Under) | | player\_assists\_q1 | 1st Quarter Assists (Over/Under) | | player\_threes | Threes (Over/Under) | | player\_blocks | Blocks (Over/Under) | | player\_steals | Steals (Over/Under) | | player\_blocks\_steals | Blocks + Steals (Over/Under) | | player\_turnovers | Turnovers (Over/Under) | | player\_points\_rebounds\_assists | Points + Rebounds + Assists (Over/Under) | | player\_points\_rebounds | Points + Rebounds (Over/Under) | | player\_points\_assists | Points + Assists (Over/Under) | | player\_rebounds\_assists | Rebounds + Assists (Over/Under) | | player\_field\_goals | Field Goals (Over/Under) | | player\_frees\_made | Frees made (Over/Under) | | player\_frees\_attempts | Frees attempted (Over/Under) | | player\_first\_basket | First Basket Scorer (Yes/No) | | player\_first\_team\_basket | First Basket Scorer on Team (Yes/No) | | player\_double\_double | Double Double (Yes/No) | | player\_triple\_double | Triple Double (Yes/No) | | player\_method\_of\_first\_basket | Method of First Basket (Various) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#alternate-nba-player-props-api) Alternate NBA Player Props API Alternate player prop markets include X+ lines, and markets labeled by bookmakers as "alternate". | Market Key
(use in the API) | Market Name | | --- | --- | | player\_points\_alternate | Alternate Points (Over/Under) | | player\_rebounds\_alternate | Alternate Rebounds (Over/Under) | | player\_assists\_alternate | Alternate Assists (Over/Under) | | player\_blocks\_alternate | Alternate Blocks (Over/Under) | | player\_steals\_alternate | Alternate Steals (Over/Under) | | player\_turnovers\_alternate | Alternate Turnovers (Over/Under) | | player\_threes\_alternate | Alternate Threes (Over/Under) | | player\_points\_assists\_alternate | Alternate Points + Assists (Over/Under) | | player\_points\_rebounds\_alternate | Alternate Points + Rebounds (Over/Under) | | player\_rebounds\_assists\_alternate | Alternate Rebounds + Assists (Over/Under) | | player\_points\_rebounds\_assists\_alternate | Alternate Points + Rebounds + Assists (Over/Under) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#mlb-player-props-api) MLB Player Props API | Market Key
(use in the API) | Market Name | | --- | --- | | batter\_home\_runs | Batter home runs (Over/Under) | | batter\_first\_home\_run | Batter first home run (Yes/No) | | batter\_hits | Batter hits (Over/Under) | | batter\_total\_bases | Batter total bases (Over/Under) | | batter\_rbis | Batter RBIs (Over/Under) | | batter\_runs\_scored | Batter runs scored (Over/Under) | | batter\_hits\_runs\_rbis | Batter hits + runs + RBIs (Over/Under) | | batter\_singles | Batter singles (Over/Under) | | batter\_doubles | Batter doubles (Over/Under) | | batter\_triples | Batter triples (Over/Under) | | batter\_walks | Batter walks (Over/Under) | | batter\_strikeouts | Batter strikeouts (Over/Under) | | batter\_stolen\_bases | Batter stolen bases (Over/Under) | | pitcher\_strikeouts | Pitcher strikeouts (Over/Under) | | pitcher\_record\_a\_win | Pitcher to record a win (Yes/No) | | pitcher\_hits\_allowed | Pitcher hits allowed (Over/Under) | | pitcher\_walks | Pitcher walks (Over/Under) | | pitcher\_earned\_runs | Pitcher earned runs (Over/Under) | | pitcher\_outs | Pitcher outs (Over/Under) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#alternate-mlb-player-props-api) Alternate MLB Player Props API | Market Key
(use in the API) | Market Name | | --- | --- | | batter\_total\_bases\_alternate | Alternate batter total bases (Over/Under) | | batter\_home\_runs\_alternate | Alternate batter home runs (Over/Under) | | batter\_hits\_alternate | Alternate batter hits (Over/Under) | | batter\_rbis\_alternate | Alternate batter RBIs (Over/Under) | | batter\_walks\_alternate | Alternate batter walks (Over/Under) | | batter\_strikeouts\_alternate | Alternate batter strikeouts (Over/Under) | | batter\_runs\_scored\_alternate | Alternate batter runs scored (Over/Under) | | batter\_singles\_alternate | Alternate batter singles (Over/Under) | | batter\_doubles\_alternate | Alternate batter doubles (Over/Under) | | batter\_triples\_alternate | Alternate batter triples (Over/Under) | | pitcher\_hits\_allowed\_alternate | Alternate pitcher hits allowed (Over/Under) | | pitcher\_walks\_alternate | Alternate pitcher walks allowed (Over/Under) | | pitcher\_strikeouts\_alternate | Alternate pitcher strikeouts (Over/Under) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#nhl-player-props-api) NHL Player Props API | Market Key
(use in the API) | Market Name | | --- | --- | | player\_points | Points (Over/Under) | | player\_power\_play\_points | Power play points (Over/Under) | | player\_assists | Assists (Over/Under) | | player\_blocked\_shots | Blocked shots (Over/Under) | | player\_shots\_on\_goal | Shots on goal (Over/Under) | | player\_goals | Goals (Over/Under) | | player\_total\_saves | Total saves (Over/Under) | | player\_goal\_scorer\_first | First Goal Scorer (Yes/No) | | player\_goal\_scorer\_last | Last Goal Scorer (Yes/No) | | player\_goal\_scorer\_anytime | Anytime Goal Scorer (Yes/No) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#alternate-nhl-player-props-api) Alternate NHL Player Props API Alternate player prop markets include X+ lines, and markets labeled by bookmakers as "alternate". | Market Key
(use in the API) | Market Name | | --- | --- | | player\_points\_alternate | Alternate Points (Over/Under) | | player\_assists\_alternate | Alternate Assists (Over/Under) | | player\_power\_play\_points\_alternate | Alternate Power Play Points (Over/Under) | | player\_goals\_alternate | Alternate Goals (Over/Under) | | player\_shots\_on\_goal\_alternate | Alternate Shots on Goal (Over/Under) | | player\_blocked\_shots\_alternate | Alternate Blocked Shots (Over/Under) | | player\_total\_saves\_alternate | Alternate Total Saves (Over/Under) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#afl-player-props-api) AFL Player Props API AFL player props are currently available from select AU bookmakers, including Sportsbet, Ladbrokes, TAB, Pointsbet and Betr | Market Key
(use in the API) | Market Name | | --- | --- | | player\_disposals | Disposals (Over/Under) | | player\_disposals\_over | Disposals (Over only) | | player\_goal\_scorer\_first | First Goal Scorer (Yes/No) | | player\_goal\_scorer\_last | Last Goal Scorer (Yes/No) | | player\_goal\_scorer\_anytime | Anytime Goal Scorer (Yes/No) | | player\_goals\_scored\_over | Goals scored (Over only) | | player\_marks\_over | Marks (Over only) | | player\_marks\_most | Most Marks (Yes/No) | | player\_tackles\_over | Tackles (Over only) | | player\_tackles\_most | Tackles (Yes/No) | | player\_afl\_fantasy\_points | AFL Fantasy Points (Over/Under) | | player\_afl\_fantasy\_points\_over | AFL Fantasy Points (Over only) | | player\_afl\_fantasy\_points\_most | Most AFL Fantasy Points (Yes/No) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#rugby-league-player-props-api) Rugby League Player Props API NRL player props are currently available from select AU bookmakers, including Sportsbet, Ladbrokes, TAB, Pointsbet and Betr | Market Key
(use in the API) | Market Name | | --- | --- | | player\_try\_scorer\_first | First Try Scorer (Yes/No) | | player\_try\_scorer\_last | Last Try Scorer (Yes/No) | | player\_try\_scorer\_anytime | Anytime Try Scorer (Yes/No) | | player\_try\_scorer\_over | Tries Scored (Over only) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#soccer-player-props-api) Soccer Player Props API Soccer player props are available for EPL, French Ligue 1, German Bundesliga, Italian Serie A, Spanish La Liga, and MLS. Coverage is currently limited to US bookmakers. | Market Key
(use in the API) | Market Name | | --- | --- | | player\_goal\_scorer\_anytime | Anytime Goal Scorer (Yes/No) | | player\_first\_goal\_scorer | First Goal Scorer (Yes/No) | | player\_last\_goal\_scorer | Last Goal Scorer (Yes/No) | | player\_to\_receive\_card | Player to receive a card (Yes/No) | | player\_to\_receive\_red\_card | Player to receive a red card (Yes/No) | | player\_shots\_on\_target | Player Shots on Target (Over/Under) | | player\_shots | Player Shots (Over/Under) | | player\_assists | Player Assists (Over/Under) | #### [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#other-soccer-betting-markets) Other soccer betting markets | Market Key
(use in the API) | Market Name | | --- | --- | | alternate\_spreads\_corners | Handicap Corners | | alternate\_totals\_corners | Total Corners (Over/Under) | | alternate\_spreads\_cards | Handicap Cards / Bookings | | alternate\_totals\_cards | Total Cards / Bookings (Over/Under) | | double\_chance | Double Chance | For half time markets, see [Game Period Markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#game-period-markets) Suggest new markets We are continuing to expand coverage of player props. [Suggest new markets & bookmakers (opens new window)](https://docs.google.com/forms/d/e/1FAIpQLSfxW8riJU92gSxT3-pEaYCTx4yvB7J3hHmV6w5ZzqYLd9R11w/viewform?embedded=true&usp=pp_url&entry.454625652=New+betting+markets) . [#](https://the-odds-api.com/sports-odds-data/betting-markets.html#get-started) Get Started -------------------------------------------------------------------------------------------- To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key Get a Free API Key → To get started with the **JSON API**, see * [Odds API docs](https://the-odds-api.com/liveapi/guides/v4/) * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the [Odds Widget](https://the-odds-api.com/widget/) To get sports odds in **Excel** or **Google Sheets** at the click of a button (no coding needed), see * [Odds in Excel](https://the-odds-api.com/features/excel.html) * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # How to Monetize Odds Data | The Odds API [#](https://the-odds-api.com/sports-odds-data/how-to-monetize-odds-data.html#how-to-monetize-odds-data) How to Monetize Odds Data ================================================================================================================================== There are a number of ways to monetize data from The Odds API depending on your goals. Live odds data can enhance existing revenue streams or create opportunities for new ones. Below are some examples of how odds data can be used to support monetization strategies. Affiliate Links Most bookmakers have generous affiliate programs, which can offer in the realm of a 30% share of profit from customers referred by you\*. These work when you provide your users with a special link to a bookmaker's website. When a user clicks the link, it tells the bookmaker that the user came from you. Relevant content is needed to maximize link clicks, and live odds data is a natural choice. \* Terms and conditions apply and vary by bookmaker [#](https://the-odds-api.com/sports-odds-data/how-to-monetize-odds-data.html#sports-apps-platforms) Sports Apps & Platforms ---------------------------------------------------------------------------------------------------------------------------- ![App Development](https://the-odds-api.com/assets/img/app-development-vector.svg) The Odds API can feed sports related apps and platforms with live odds. Examples of apps include * Odds comparison apps * Odds notification services * Sports stats showing live odds in conjuction with data from other sources * Odds analytics platforms Data from The Odds API can be central to an app, or could suppliment data from other sources. Odds data could be monetized as an app feature (for example, "upgrade to see odds for more sports"), or could be used with bookmaker affiliate links to drive affiliate revenue. [#](https://the-odds-api.com/sports-odds-data/how-to-monetize-odds-data.html#sports-news-blog-websites) Sports News & Blog Websites ------------------------------------------------------------------------------------------------------------------------------------ ![Website](https://the-odds-api.com/assets/img/website-vector.svg) If you publish sports related articles, combining dynamic odds with news updates can be a powerful recipe for user engagement. Additionally, odds changes over time gives insight into market sentiment which can serve as the focal point of an article. More engaging content can lead to improved ad revenue and more shares and likes. Odds data can also be displayed with bookmaker affiliate links for an additional revenue stream. [#](https://the-odds-api.com/sports-odds-data/how-to-monetize-odds-data.html#betting-strategies) Betting Strategies -------------------------------------------------------------------------------------------------------------------- ![Trading Bars](https://the-odds-api.com/assets/img/trading-vector.svg) Data from The Odds API can be used to help develop betting strategies. For example when combined with news data, analysis might reveal leading indicators before odds markets respond. If you use the [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) add-on, live odds data can easily be combined with your own formulas in a spreadsheet to help guide betting decisions. [#](https://the-odds-api.com/sports-odds-data/how-to-monetize-odds-data.html#get-started) Get Started ------------------------------------------------------------------------------------------------------ Get started with The Odds API by signing up to a [free plan](https://the-odds-api.com/#get-access) If you're building an app or website, we've designed the API to be simple to use, well documented and easy to maintain, helping lower your development costs and integration time. To get started with the JSON API, see * [API docs](https://the-odds-api.com/liveapi/guides/v4/) * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) To get odds in Excel or Google Sheets at the click of a button (no coding skills needed), see * [Odds in Excel](https://the-odds-api.com/features/excel.html) * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # Odds Formats | The Odds API [#](https://the-odds-api.com/sports-odds-data/odds-format.html#odds-format) Odds Format ======================================================================================== The Odds API supports both decimal and American odds formats. This page contains explanations of the different odds formats, and formulas to convert between formats. [#](https://the-odds-api.com/sports-odds-data/odds-format.html#decimal-odds-format) Decimal Odds Format -------------------------------------------------------------------------------------------------------- Odds data is in **decimal format** by default. The payout of a bet is the decimal odd multiplied by your wager. Example Consider team A with decimal odds **1.4**, and team B with decimal odds **3.9** If you wager $100 on team A and win, you’ll receive a payout of `100 x 1.4 = $140`, and profit of `140 - 100 = $40`. If you wager $100 on team B and win, you’ll receive a payout of `100 x 3.9 = $390`, and profit of `390 - 100 = $290`. [#](https://the-odds-api.com/sports-odds-data/odds-format.html#american-odds-format) American Odds Format ---------------------------------------------------------------------------------------------------------- The American odds format can display odds as positive or negative integers. If the American odds value is positive, the value represents the profit of a $100 wager. If the American odds value is negative, the value represents the amount that needs to be wagered to receive a profit of $100. Example Consider team A with American odds **\-420**, and team B with American odds **+330** If you wager $420 on team A and win, you will receive a profit of `$100`, and a total payout of `$420 (original wager) + $100 (profit) = $520`. If you wager $100 on team B and win, you will receive a profit of `$330`, and a total payout of `$100 (original wager) + $330 (profit) = $430`. [#](https://the-odds-api.com/sports-odds-data/odds-format.html#converting-decimal-odds-to-american-odds) Converting Decimal Odds To American Odds -------------------------------------------------------------------------------------------------------------------------------------------------- To convert decimal odds to American odds, use the following formulas. If the decimal odd is greater than or equal to 2, apply this formula: A = (D - 1) x 100 If the decimal odd is less than 2, apply this formula: A = 100 / (1 - D) where `D` is the decimal odd and `A`is the American odd. Example Consider team A with decimal odds **1.4**, and team B with decimal odds **3.9** **3.9** is above 2, so apply the first formula: A = (3.9 - 1) x 100 = **290** **1.4** is less than 2, so apply the second formula: A = 100 / (1 - 1.4) = **\-250** [#](https://the-odds-api.com/sports-odds-data/odds-format.html#malaysian-odds-malay-odds-format) Malaysian Odds (Malay Odds) Format ------------------------------------------------------------------------------------------------------------------------------------ The Odds API does not currently support Malaysian odds, however Malaysian odds can be calculated from decimal odds. Malaysian odds are represented as positive or negative decimals. * Positive Malaysian Odds: These odds indicate how much profit you can make on a unit stake. If the odds are +0.75, for every $1 you wager, you can make a profit of $0.75. * Negative Malaysian Odds: These odds tell you how much you need to stake in order to make a unit profit. If the odds are -0.25, you need to stake $0.25 to make a profit of $1. [#](https://the-odds-api.com/sports-odds-data/odds-format.html#converting-decimal-odds-to-malaysian-odds) Converting Decimal Odds to Malaysian Odds ---------------------------------------------------------------------------------------------------------------------------------------------------- If the decimal odd is less than 2, apply this formula: M = D - 1 If the decimal odd is greater than or equal to 2, apply this formula: M = 1 / (1 - D) where `D` is the decimal odd and `M`is the Malaysian odd. [#](https://the-odds-api.com/sports-odds-data/odds-format.html#get-started-with-the-odds-api) Get Started with The Odds API ---------------------------------------------------------------------------------------------------------------------------- * Get a free [API key](https://the-odds-api.com/) * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/) * Check out our [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) * Check out add-ons to bring odds data into [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) or [Excel](https://the-odds-api.com/features/excel.html) --- # Football Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/football-odds.html#football-odds) Football Odds ============================================================================================== Get access to current football odds in [Excel](https://the-odds-api.com/features/excel.html) , [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) or [JSON API](https://the-odds-api.com/liveapi/guides/v4/) . [#](https://the-odds-api.com/sports-odds-data/football-odds.html#football-odds-data) Football Odds Data -------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports-odds-data/football-odds.html#leagues) Leagues We cover several football leagues across the globe * **UK & EU football (soccer) odds** EPL, FA Cup, German Bundesliga, UEFA Europa & Champions Leagues, Italian Serie A, Spanish La Liga, SPL, A-league and much more * **US & Aussie football odds**NFL, XFL, CFL, College Football (NCAA), Aussie Rules (AFL) ### [#](https://the-odds-api.com/sports-odds-data/football-odds.html#bookmakers) Bookmakers See the full [list of bookmakers →](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) [#](https://the-odds-api.com/sports-odds-data/football-odds.html#football-odds-in-excel-and-google-sheets) Football Odds in Excel and Google Sheets ---------------------------------------------------------------------------------------------------------------------------------------------------- Access current football odds in [Excel](https://the-odds-api.com/features/excel.html) and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) at the click of a button. Simply select the league and the region for bookmakers, and click **Fetch** to populate your spreadsheet with recent football odds. ![Sports Odds in Excel](https://the-odds-api.com/assets/img/football-odds-in-sheets.jpg) Football odds data includes match listings, match start times, and odds (decimal format) from a range of global bookmakers. The delay on odds ranges from a few seconds to a few minutes, and typically no more than a minute during live football matches. ### [#](https://the-odds-api.com/sports-odds-data/football-odds.html#get-started) Get Started To get football odds into Excel or Google Sheets, you'll need 1. [A free API key](https://the-odds-api.com/#get-access) 2. The [add on for Excel (opens new window)](https://store.office.com/en-us/app.aspx?assetid=WA104380819&sourcecorrid=cf8fc15c-ea73-47af-b898-b8513c4e8384&ui=en-US&rs=en-US&ad=US&appredirect=false) or the [add on for Google Sheets (opens new window)](https://workspace.google.com/marketplace/app/sports_odds_plus/648207346109) [#](https://the-odds-api.com/sports-odds-data/football-odds.html#football-odds-json-api) Football Odds JSON API ---------------------------------------------------------------------------------------------------------------- Developers can access football odds with our simple JSON API. To see football odds for live and upcoming games, specify the sport, region of bookmakers (us, us2, uk, eu or au) and your [API key](https://the-odds-api.com/) in a simple GET request. For more details, see the [API docs](https://the-odds-api.com/liveapi/guides/v4/) . **Example Request** GET https://api.the-odds-api.com/v4/sports/soccer_epl/odds?regions=uk&apiKey=YOUR_API_KEY { "id": "0ba40aad3c918f52363117a71f5de8e8", "sport_key": "soccer_epl", "sport_title": "EPL", "commence_time": "2023-04-01T11:30:00Z", "home_team": "Manchester City", "away_team": "Liverpool", "bookmakers": [\ {\ "key": "williamhill",\ "title": "William Hill",\ "last_update": "2023-03-26T23:04:06Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-03-26T23:04:06Z",\ "outcomes": [\ { "name": "Liverpool", "price": 5.5 },\ { "name": "Manchester City", "price": 1.57 },\ { "name": "Draw", "price": 4.0 }\ ]\ }\ ]\ },\ ...\ \ ### [#](https://the-odds-api.com/sports-odds-data/football-odds.html#get-started-2)\ Get Started\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out our [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) --- # Odds API Update Interval | The Odds API [#](https://the-odds-api.com/sports-odds-data/update-intervals.html#odds-api-update-intervals) Odds API Update Intervals ========================================================================================================================= Odds update at intervals which depend on the market type and the proximity to an event's start time. | Market Type | Pre-Match Update Interval | In-Play Update Interval | | --- | --- | --- | | [Featured Markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#featured-betting-markets)

head to head / moneyline / 1x2, spreads / handicaps, totals / over & under | 60 seconds | 40 seconds | | [Additional markets](https://the-odds-api.com/sports-odds-data/betting-markets.html#additional-markets)

player props, alternates, period markets | 60 seconds | 60 seconds | | Outrights / futures | 5 minutes | 60 seconds | | Betting exchanges (all markets) | 30 seconds | 20 seconds | Six hours before an event's start time, the update interval begins decreasing from the pre-match interval, eventually reaching the in-play interval once the event goes live. ![Odds Update Interval](https://the-odds-api.com/assets/img/interval.svg) [Your suggestions (opens new window)](https://docs.google.com/forms/d/e/1FAIpQLSfxW8riJU92gSxT3-pEaYCTx4yvB7J3hHmV6w5ZzqYLd9R11w/viewform?embedded=true&usp=pp_url&entry.454625652=Update+Intervals) can help inform future changes to the update intervals. [#](https://the-odds-api.com/sports-odds-data/update-intervals.html#get-started) Get Started --------------------------------------------------------------------------------------------- To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key Get a Free API Key → To get started with the **JSON API**, see * [Odds API docs](https://the-odds-api.com/liveapi/guides/v4/) * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the [Odds Widget](https://the-odds-api.com/widget/) To get sports odds in **Excel** or **Google Sheets** at the click of a button (no coding needed), see * [Odds in Excel](https://the-odds-api.com/features/excel.html) * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # Sports APIs | The Odds API [#](https://the-odds-api.com/sports-odds-data/sports-apis.html#sports) Sports ============================================================================== All usage plans give access to all available sports. These sports are covered by the API when in season: [#](https://the-odds-api.com/sports-odds-data/sports-apis.html#sports-odds-apis) Sports Odds APIs -------------------------------------------------------------------------------------------------- | Group | League / Tournament | Sport Key
(use in the API) | Scores & Results | | --- | --- | --- | --- | | American Football | CFL | americanfootball\_cfl | ✔ | | American Football | NCAAF | americanfootball\_ncaaf | ✔ | | American Football | NCAAF Championship Winner | americanfootball\_ncaaf\_championship\_winner | | | American Football | NFL | americanfootball\_nfl | ✔ | | American Football | NFL Preseason | americanfootball\_nfl\_preseason | ✔ | | American Football | NFL Super Bowl Winner | americanfootball\_nfl\_super\_bowl\_winner | | | American Football | UFL | americanfootball\_ufl | ✔ | | Aussie Rules | AFL | aussierules\_afl | ✔ | | Baseball | MLB | baseball\_mlb | ✔ | | Baseball | MLB Preseason | baseball\_mlb\_preseason | | | Baseball | MLB World Series Winner | baseball\_mlb\_world\_series\_winner | | | Baseball | Minor League Baseball | baseball\_milb | | | Baseball | NPB | baseball\_npb | | | Baseball | KBO League | baseball\_kbo | | | Baseball | NCAA Baseball | baseball\_ncaa | | | Basketball | Basketball Euroleague | basketball\_euroleague | ✔ | | Basketball | NBA | basketball\_nba | ✔ | | Basketball | NBA Preseason | basketball\_nba\_preseason | ✔ | | Basketball | NBA Summer League | basketball\_nba\_summer\_league | ✔ | | Basketball | NBA Championship Winner | basketball\_nba\_championship\_winner | | | Basketball | WNBA | basketball\_wnba | ✔ | | Basketball | NCAAB | basketball\_ncaab | ✔ | | Basketball | WNCAAB | basketball\_wncaab | | | Basketball | NCAAB Championship Winner | basketball\_ncaab\_championship\_winner | | | Basketball | NBL (Australia) | basketball\_nbl | | | Boxing | Boxing | boxing\_boxing | | | Cricket | Asia Cup | cricket\_asia\_cup | | | Cricket | Big Bash | cricket\_big\_bash | | | Cricket | Caribbean Premier League | cricket\_caribbean\_premier\_league | | | Cricket | ICC Champions Trophy | cricket\_icc\_trophy | | | Cricket | ICC World Cup | cricket\_icc\_world\_cup | | | Cricket | ICC Women's World Cup | cricket\_icc\_world\_cup\_womens | | | Cricket | International Twenty20 | cricket\_international\_t20 | | | Cricket | IPL | cricket\_ipl | | | Cricket | One Day Internationals | cricket\_odi | | | Cricket | Pakistan Super League | cricket\_psl | | | Cricket | T20 Blast | cricket\_t20\_blast | | | Cricket | Test Matches | cricket\_test\_match | | | Cricket | The Hundred | cricket\_the\_hundred | | | Golf | Masters Tournament Winner | golf\_masters\_tournament\_winner | | | Golf | PGA Championship Winner | golf\_pga\_championship\_winner | | | Golf | The Open Winner | golf\_the\_open\_championship\_winner | | | Golf | US Open Winner | golf\_us\_open\_winner | | | Handball | Handball-Bundesliga | handball\_germany\_bundesliga | ✔ | | Ice Hockey | NHL | icehockey\_nhl | ✔ | | Ice Hockey | NHL Preseason | icehockey\_nhl\_preseason | ✔ | | Ice Hockey | AHL | icehockey\_ahl | | | Ice Hockey | NHL Championship Winner | icehockey\_nhl\_championship\_winner | | | Ice Hockey | Finnish Liiga | icehockey\_liiga | | | Ice Hockey | Finnish Mestis | icehockey\_mestis | | | Ice Hockey | SHL | icehockey\_sweden\_hockey\_league | ✔ | | Ice Hockey | HockeyAllsvenskan | icehockey\_sweden\_allsvenskan | ✔ | | Lacrosse | Premier Lacrosse League | lacrosse\_pll | | | Lacrosse | NCAA Lacrosse | lacrosse\_ncaa | | | Mixed Martial Arts | MMA | mma\_mixed\_martial\_arts | | | Politics | US Presidential Elections Winner | politics\_us\_presidential\_election\_winner | | | Rugby League | NRL | rugbyleague\_nrl | ✔ | | Rugby League | NRL State of Origin | rugbyleague\_nrl\_state\_of\_origin | | | Rugby Union | Six Nations | rugbyunion\_six\_nations | | | Soccer | Africa Cup of Nations | soccer\_africa\_cup\_of\_nations | | | Soccer | Primera División - Argentina | soccer\_argentina\_primera\_division | ✔ | | Soccer | A-League | soccer\_australia\_aleague | ✔ | | Soccer | Austrian Football Bundesliga | soccer\_austria\_bundesliga | ✔ | | Soccer | Belgium First Div | soccer\_belgium\_first\_div | ✔ | | Soccer | Brazil Série A | soccer\_brazil\_campeonato | ✔ | | Soccer | Brazil Série B | soccer\_brazil\_serie\_b | ✔ | | Soccer | Primera División - Chile | soccer\_chile\_campeonato | ✔ | | Soccer | Super League - China | soccer\_china\_superleague | ✔ | | Soccer | Denmark Superliga | soccer\_denmark\_superliga | ✔ | | Soccer | Championship | soccer\_efl\_champ | ✔ | | Soccer | EFL Cup | soccer\_england\_efl\_cup | ✔ | | Soccer | League 1 | soccer\_england\_league1 | ✔ | | Soccer | League 2 | soccer\_england\_league2 | ✔ | | Soccer | EPL | soccer\_epl | ✔ | | Soccer | FA Cup | soccer\_fa\_cup | ✔ | | Soccer | FIFA World Cup | soccer\_fifa\_world\_cup | ✔ | | Soccer | FIFA World Cup Qualifiers - Europe | soccer\_fifa\_world\_cup\_qualifiers\_europe | | | Soccer | FIFA World Cup Qualifiers - South America | soccer\_fifa\_world\_cup\_qualifiers\_south\_america | | | Soccer | FIFA Women's World Cup | soccer\_fifa\_world\_cup\_womens | ✔ | | Soccer | FIFA World Cup Winner | soccer\_fifa\_world\_cup\_winner | | | Soccer | FIFA Club World Cup | soccer\_fifa\_club\_world\_cup | ✔ | | Soccer | Veikkausliiga - Finland | soccer\_finland\_veikkausliiga | ✔ | | Soccer | Ligue 1 - France | soccer\_france\_ligue\_one | ✔ | | Soccer | Ligue 2 - France | soccer\_france\_ligue\_two | ✔ | | Soccer | Bundesliga - Germany | soccer\_germany\_bundesliga | ✔ | | Soccer | Bundesliga 2 - Germany | soccer\_germany\_bundesliga2 | ✔ | | Soccer | 3\. Liga - Germany | soccer\_germany\_liga3 | ✔ | | Soccer | Super League - Greece | soccer\_greece\_super\_league | ✔ | | Soccer | Serie A - Italy | soccer\_italy\_serie\_a | ✔ | | Soccer | Serie B - Italy | soccer\_italy\_serie\_b | ✔ | | Soccer | J League | soccer\_japan\_j\_league | ✔ | | Soccer | K League 1 | soccer\_korea\_kleague1 | ✔ | | Soccer | League of Ireland | soccer\_league\_of\_ireland | ✔ | | Soccer | Liga MX | soccer\_mexico\_ligamx | ✔ | | Soccer | Dutch Eredivisie | soccer\_netherlands\_eredivisie | ✔ | | Soccer | Eliteserien - Norway | soccer\_norway\_eliteserien | ✔ | | Soccer | Ekstraklasa - Poland | soccer\_poland\_ekstraklasa | ✔ | | Soccer | Primeira Liga - Portugal | soccer\_portugal\_primeira\_liga | ✔ | | Soccer | Premier League - Russia | soccer\_russia\_premier\_league | ✔ | | Soccer | La Liga - Spain | soccer\_spain\_la\_liga | ✔ | | Soccer | La Liga 2 - Spain | soccer\_spain\_segunda\_division | ✔ | | Soccer | Premiership - Scotland | soccer\_spl | ✔ | | Soccer | Allsvenskan - Sweden | soccer\_sweden\_allsvenskan | ✔ | | Soccer | Superettan - Sweden | soccer\_sweden\_superettan | ✔ | | Soccer | Swiss Superleague | soccer\_switzerland\_superleague | ✔ | | Soccer | Turkey Super League | soccer\_turkey\_super\_league | ✔ | | Soccer | UEFA Europa Conference League | soccer\_uefa\_europa\_conference\_league | ✔ | | Soccer | UEFA Champions League | soccer\_uefa\_champs\_league | ✔ | | Soccer | UEFA Champions League Qualification | soccer\_uefa\_champs\_league\_qualification | ✔ | | Soccer | UEFA Women's Champions League | soccer\_uefa\_champs\_league\_women | ✔ | | Soccer | UEFA Europa League | soccer\_uefa\_europa\_league | ✔ | | Soccer | UEFA Euro 2024 | soccer\_uefa\_european\_championship | ✔ | | Soccer | UEFA Euro Qualification | soccer\_uefa\_euro\_qualification | ✔ | | Soccer | UEFA Nations League | soccer\_uefa\_nations\_league | ✔ | | Soccer | CONCACAF Gold Cup | soccer\_concacaf\_gold\_cup | | | Soccer | CONCACAF Leagues Cup | soccer\_concacaf\_leagues\_cup | ✔ | | Soccer | Copa América | soccer\_conmebol\_copa\_america | ✔ | | Soccer | Copa Libertadores | soccer\_conmebol\_copa\_libertadores | ✔ | | Soccer | Copa Sudamericana | soccer\_conmebol\_copa\_sudamericana | ✔ | | Soccer | MLS | soccer\_usa\_mls | ✔ | | Tennis | ATP Australian Open | tennis\_atp\_aus\_open\_singles | | | Tennis | ATP Canadian Open | tennis\_atp\_canadian\_open | | | Tennis | ATP China Open | tennis\_atp\_china\_open | | | Tennis | ATP Cincinnati Open | tennis\_atp\_cincinnati\_open | | | Tennis | ATP Dubai Championships | tennis\_atp\_dubai | | | Tennis | ATP French Open | tennis\_atp\_french\_open | | | Tennis | ATP Indian Wells | tennis\_atp\_indian\_wells | | | Tennis | ATP Italian Open | tennis\_atp\_italian\_open | | | Tennis | ATP Madrid Open | tennis\_atp\_madrid\_open | | | Tennis | ATP Miami Open | tennis\_atp\_miami\_open | | | Tennis | ATP Monte-Carlo Masters | tennis\_atp\_monte\_carlo\_masters | | | Tennis | ATP Paris Masters | tennis\_atp\_paris\_masters | | | Tennis | ATP Qatar Open | tennis\_atp\_qatar\_open | | | Tennis | ATP Shanghai Masters | tennis\_atp\_shanghai\_masters | | | Tennis | ATP US Open | tennis\_atp\_us\_open | | | Tennis | ATP Wimbledon | tennis\_atp\_wimbledon | | | Tennis | WTA Australian Open | tennis\_wta\_aus\_open\_singles | | | Tennis | WTA Canadian Open | tennis\_wta\_canadian\_open | | | Tennis | WTA China Open | tennis\_wta\_china\_open | | | Tennis | WTA Cincinnati Open | tennis\_wta\_cincinnati\_open | | | Tennis | WTA Dubai Championships | tennis\_wta\_dubai | | | Tennis | WTA French Open | tennis\_wta\_french\_open | | | Tennis | WTA Indian Wells | tennis\_wta\_indian\_wells | | | Tennis | WTA Italian Open | tennis\_wta\_italian\_open | | | Tennis | WTA Madrid Open | tennis\_wta\_madrid\_open | | | Tennis | WTA Miami Open | tennis\_wta\_miami\_open | | | Tennis | WTA Qatar Open | tennis\_wta\_qatar\_open | | | Tennis | WTA US Open | tennis\_wta\_us\_open | | | Tennis | WTA Wimbledon | tennis\_wta\_wimbledon | | | Tennis | WTA Wuhan Open | tennis\_wta\_wuhan\_open | | We are always looking to add new sports: [suggest a sport (opens new window)](https://docs.google.com/forms/d/e/1FAIpQLSfxW8riJU92gSxT3-pEaYCTx4yvB7J3hHmV6w5ZzqYLd9R11w/viewform?embedded=true&usp=pp_url&entry.454625652=New+sports,+leagues+or+competitions) [#](https://the-odds-api.com/sports-odds-data/sports-apis.html#get-started) Get Started ---------------------------------------------------------------------------------------- The best way to discover the sports and bookmakers we cover is to sign up for a [free API key](https://the-odds-api.com/#get-access) . To get odds in Excel or Google Sheets at the click of a button (no coding skills needed), see * [Odds in Excel](https://the-odds-api.com/features/excel.html) * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) To get started with the JSON API, see * [API docs](https://the-odds-api.com/liveapi/guides/v4/) * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) --- # Betting Markets - Examples | The Odds API [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#examples-of-betting-markets) Examples of Betting Markets ===================================================================================================================================== This page includes examples of some of the [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) covered by The Odds API. [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#head-to-head-moneyline-bets) Head to Head / Moneyline Bets --------------------------------------------------------------------------------------------------------------------------------------- These examples use American odds: > $250 is wagered on a team with odds of -250. If the team wins, the bettor receives a profit of $100, and a payout of $250 + $100 = $350 > $100 is wagered on a team with odds of 300. If the team wins, the bettor receives a profit of $300, and a payout of $100 + $300 = $400 This example uses decimal odds: > $100 wagered on a team with odds of 2.5. If the team wins, the bettor receives a payout of 100 x 2.5 = $250, and a profit of $250 - $100 = $150 [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#lay-bets-for-head-to-head-moneyline) Lay Bets for Head to Head / Moneyline ------------------------------------------------------------------------------------------------------------------------------------------------------- Laying a bet is like taking the position of a bookmaker. A bet is made _against_ a winning outcome. This example uses decimal odds: > If you wager $100 on a team with decimal odds of 2 as a lay bet, you are betting the team will lose. Another bettor is backing your bet by wagering $100 on those same odds of 2. If the team wins, you lose your $100 to the backer (their profit, your loss). If the team loses, you keep the backer's wager of $100 (your profit, their loss), giving you a payout of $100 + $100 = $200 [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#point-spread-handicap-bets) Point Spread / Handicap Bets ------------------------------------------------------------------------------------------------------------------------------------- Bet on the winning team after a handicap of points has been applied on each team. This example uses American odds: > A Utah Jazz vs LA Clippers game had point spread odds of Utah Jazz -112 (-3.5 points) and LA Clippers -109 (+3.5 points). > Utah Jazz is seen as the stronger team and is handicapped by 3.5 points. LA Clippers are given a bonus of +3.5 points. > If you bet on Utah Jazz, they will need to win by more than 3.5 points (i.e. at least 4 points) in order to win the bet at odds -112. If you bet on LA Clippers, they can either lose by less the 3.5 points (i.e. lose by 3 points or less), or win the game in order to win the bet at odds of -109. [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#totals-over-under-bets) Totals / Over/Under Bets ----------------------------------------------------------------------------------------------------------------------------- Bet on the total score of the game being above or below a threshold. This example uses American odds: > A Utah Jazz vs LA Clippers game showed over/under odds as _over 234.5 points_ at odds of -109, _under 234.5 points_ at odds -112. > A bet on the _over_ side will win if the total points of the game are 235 or more. > A bet on the _under_ side will win if the total points of the game are 234 or less. [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#outrights-futures-bets) Outrights / Futures Bets ----------------------------------------------------------------------------------------------------------------------------- Futures bets try to pick the final outcome of a tournament or a competition, usually amongst many possible outcomes. Examples include * Betting on the winning team of this season's NFL Superbowl * Betting on a player finishing in the top 3 of a golf tournament * Betting on the next US President amongst the candidates [#](https://the-odds-api.com/sports-odds-data/betting-markets-examples.html#get-started) Get Started ===================================================================================================== To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key Get a Free API Key → To get started with the **JSON API**, see * [Odds API docs](https://the-odds-api.com/liveapi/guides/v4/) * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the [Odds Widget](https://the-odds-api.com/widget/) To get sports odds in **Excel** or **Google Sheets** at the click of a button (no coding needed), see * [Odds in Excel](https://the-odds-api.com/features/excel.html) * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # Terms and Conditions | The Odds API [#](https://the-odds-api.com/terms-and-conditions.html#the-odds-api-terms-and-conditions) The Odds API Terms and Conditions ---------------------------------------------------------------------------------------------------------------------------- By purchasing any of our products, you agree to these terms and conditions. ### [#](https://the-odds-api.com/terms-and-conditions.html#definitions) Definitions The API service is provided by The Odds API Pty Ltd, ACN: 627461947 (“The Odds API”, “We” or “Us”). Users (or “You”) are defined as any person who has registered to use the API service. Service is defined as the API service and its associated data. ### [#](https://the-odds-api.com/terms-and-conditions.html#liability) Liability We take care to ensure the accuracy and timeliness of our data. However on occasion, errors may be present in the data. We will not be held liable for losses resulting from actions made on the data provided in our API, whether the data is correct or erroneous or outdated. It is your responsibility to independently verify the accuracy of the data before using it. We encourage you to inform us of any errors. We will not be liable for any losses resulting from actions taken on the basis of our API data. We assume no responsibility for any products created by users of the API service using the API data. ### [#](https://the-odds-api.com/terms-and-conditions.html#restrictions) Restrictions Do not resell, repackage, or redistribute our data as a standalone data product. This includes, but is not limited to, offering our data through your own API, data feed, downloadable files, or any other format intended to serve as a source of raw data for others. We support and encourage the use of our data in websites, mobile apps, internal dashboards, analytical tools (e.g., Excel, Google Sheets), and other user-facing applications, including commercial use, provided our data is not the primary product being sold or redistributed. If we suspect a violation of these terms, including the resale or redistribution of our data as a data service, we reserve the right to revoke your API key and block future access. If you're unsure whether your use case is permitted, please contact us. ### [#](https://the-odds-api.com/terms-and-conditions.html#api-key-responsibility) API Key Responsibility Once registered for the API service, you will receive an API key via email. The API key is a randomly generated string associated with your purchased usage plan. It is your responsibility to keep your API key private. Failure to keep your API key private will make it vulnerable to quota depletion by unauthorized users. If you suspect that the privacy of your API has been breached, you can request a new API key. ### [#](https://the-odds-api.com/terms-and-conditions.html#cancellations-refunds) Cancellations & Refunds You may cancel your access to the API service at any time. However, payments are non-refundable, so your subscription will remain active until the end of the current billing cycle. If you forget to cancel and are charged for a new billing cycle, please contact us at team@the-odds-api.com. Refund requests will be considered on a case-by-case basis and are granted solely at our discretion. ### [#](https://the-odds-api.com/terms-and-conditions.html#appropriate-usage-and-abuse) Appropriate Usage and Abuse If we suspect abuse or malicious intent by users of our service, we reserve the right to terminate API access for an API key, and/or to block IP addresses, at any time without warning. ### [#](https://the-odds-api.com/terms-and-conditions.html#add-on-privacy) Add-on Privacy When using the Sports Odds add-on for Google Sheets or Microsoft Excel, no personal information is collected. We may collect anonymous usage information for the purposes of product improvement. --- # Football Betting Data | The Odds API [#](https://the-odds-api.com/sports-odds-data/football-betting-data.html#football-betting-data) Football Betting Data ====================================================================================================================== The Odds API returns dynamic betting odds data from several bookmakers across countless football leagues. We aggregate football betting data from over 40 bookmakers around the world, and make these available in a simple [JSON API](https://the-odds-api.com/liveapi/guides/v4/) , as well as in [Excel](https://the-odds-api.com/features/excel.html) and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . If you're a punter, analyst or just curious about odds data, we offer spreadsheet add ons which bring the latest football betting data into your spreadsheets at the click of a button. Add ons are available for [Excel](https://the-odds-api.com/features/excel.html) and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . ![Football odds data in Google Sheets](https://the-odds-api.com/assets/img/sports-odds-in-sheets.gif) If you're a developer or have access to a development team, the JSON API delivers football odds data in a simple format allowing for fast, low cost integration with your application. For more info, see [the API docs →](https://the-odds-api.com/liveapi/guides/v4/) ... "sport_nice": "NFL", "teams": ["Chicago Bears", "Tampa Bay Buccaneers"], "home_team": "Chicago Bears", "commence_time": "2020-10-09T00:20:00Z", "sites": [\ {\ "site_key": "fanduel",\ "site_nice": "FanDuel",\ "last_update": "2020-10-06T08:00:04Z",\ "odds": {"h2h": [198,-240]}\ },\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": "2020-10-06T07:57:36Z",\ "odds": {"h2h": [205,-238]}\ },\ ...\ \ \ [#](https://the-odds-api.com/sports-odds-data/football-betting-data.html#dynamic-odds-for-football-betting-data)\ Dynamic Odds for Football Betting Data\ --------------------------------------------------------------------------------------------------------------------------------------------------------\ \ Football betting odds data is refreshed every few minutes on average for pre-match games, and updates more frequently as games go live (approx. every 30 seconds).\ \ Looking for **historic betting odds data**? We're working on it! Feel free to [contact us](mailto:team@the-odds-api.com)\ about your requirements.\ \ [#](https://the-odds-api.com/sports-odds-data/football-betting-data.html#football-leagues-betting-data)\ Football Leagues Betting Data\ --------------------------------------------------------------------------------------------------------------------------------------\ \ We cover several football leagues across the globe\ \ * **US & Aussie football odds data** NFL, College Football (NCAA) and Aussie Rules (AFL)\ \ * **UK & EU football odds data** EPL, FA Cup, German Bundesliga, UEFA Europa & Champions Leagues, Italian Serie A, Spanish La Liga, SPL, A-league and _much more_\ \ \ [#](https://the-odds-api.com/sports-odds-data/football-betting-data.html#bookmakers-listing-football-betting-data)\ Bookmakers Listing Football Betting Data\ ------------------------------------------------------------------------------------------------------------------------------------------------------------\ \ We collect football betting data from over 30 popular bookmakers around the world, and the list continues to grow.\ \ For more info, see the full [list of bookmakers →](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ [#](https://the-odds-api.com/sports-odds-data/football-betting-data.html#data-format)\ Data Format\ --------------------------------------------------------------------------------------------------\ \ The Odds API offers football betting odds data in both American and decimal formats.\ \ [More info on odds formats →](https://the-odds-api.com/sports-odds-data/odds-format.html)\ \ [#](https://the-odds-api.com/sports-odds-data/football-betting-data.html#get-started)\ Get Started\ --------------------------------------------------------------------------------------------------\ \ \ \ To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key\ \ Get a Free API Key →\ \ \ \ To get started with the **JSON API**, see\ \ * [Odds API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html)\ \ \ To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the [Odds Widget](https://the-odds-api.com/widget/)\ \ To get sports odds in **Excel** or **Google Sheets** at the click of a button (no coding needed), see\ \ * [Odds in Excel](https://the-odds-api.com/features/excel.html)\ \ * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # Live Sports Odds | The Odds API [#](https://the-odds-api.com/sports-odds-data/live-sports-odds.html#live-sports-odds) Live Sports Odds ======================================================================================================= The Odds API aggregates live sports odds data into an easy-to-use format. Sports odds data is collected from over 40 bookmakers for countless sports. [#](https://the-odds-api.com/sports-odds-data/live-sports-odds.html#live-sports-odds-2) Live Sports Odds --------------------------------------------------------------------------------------------------------- The Odds API delivers live sports odds for several in-season sports including * **Football odds data:** NFL, College Football (NCAA), CFL, Aussie Rules (AFL) * **Soccer odds data:** EPL, EFL Championship, German Bundesliga, UEFA Europa & Champions Leagues, Italian Serie A, Spanish La Liga, Brazil Série A, French Ligue 1 and much more * **Basketball odds data:** NBA, WNBA, US College Basketball (NCAA), Euroleague and more * **Baseball odds data:** MLB, MiLB, KBO, NPB * **Ice hockey odds data:** NHL, SHL, HockeyAllsvenskan and more * **Cricket odds data:** Test matches, IPL, Big Bash and more * **Rugby league odds data:** Aussie NRL * **Golf odds data:** Masters Tournament, PGA Championship, US Open, The Open Championship * **Tennis odds data:** All Grand Slams and more * **Politics odds data:** Next US President odds * **And more** [#](https://the-odds-api.com/sports-odds-data/live-sports-odds.html#live-bookmaker-odds) Live Bookmaker Odds ------------------------------------------------------------------------------------------------------------- The Odds API offers live sports odds from over 40 popular bookmakers around the world, and the list continues to grow. For more info, see the [full list of bookmakers →](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) [#](https://the-odds-api.com/sports-odds-data/live-sports-odds.html#using-live-odds) Using Live Odds ----------------------------------------------------------------------------------------------------- If you're a punter, analyst or just curious about odds data, we offer spreadsheet add ons which bring the live sports odds betting data into your spreadsheets at the click of a button. Add ons are available for [Excel](https://the-odds-api.com/features/excel.html) and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . ![Football odds data in Google Sheets](https://the-odds-api.com/assets/img/sports-odds-in-sheets.gif) If you're a developer or have access to a development team, the JSON API delivers live sports odds data in a simple format allowing for fast, low cost integration with your application. For more info, see [the API docs →](https://the-odds-api.com/liveapi/guides/v4/) ... "sport_nice": "NFL", "teams": ["Chicago Bears", "Tampa Bay Buccaneers"], "home_team": "Chicago Bears", "commence_time": "2020-10-09T00:20:00Z", "sites": [\ {\ "site_key": "fanduel",\ "site_nice": "FanDuel",\ "last_update": "2020-10-06T08:00:04Z",\ "odds": {"h2h": [198,-240]}\ },\ {\ "site_key": "unibet",\ "site_nice": "Unibet",\ "last_update": "2020-10-06T07:57:36Z",\ "odds": {"h2h": [205,-238]}\ },\ ...\ \ \ \ \ There are several ways to monetize sports odds data depending on your circumstances. See [how to monetize sports odds](https://the-odds-api.com/sports-odds-data/how-to-monetize-odds-data.html)\ for more info.\ \ Get access to [live sports odds for free →](https://the-odds-api.com/#get-access)\ \ [#](https://the-odds-api.com/sports-odds-data/live-sports-odds.html#latency-of-sports-odds-data)\ Latency of Sports Odds Data\ -----------------------------------------------------------------------------------------------------------------------------\ \ Sports odds odds data is refreshed every few minutes on average for pre-match games, and updates more frequently as games go live (approx. every 30 seconds).\ \ Looking for **historic sports odds data**? We're working on it! Feel free to [contact us](mailto:team@the-odds-api.com)\ about your requirements.\ \ [#](https://the-odds-api.com/sports-odds-data/live-sports-odds.html#get-started)\ Get Started\ ---------------------------------------------------------------------------------------------\ \ \ \ To discover the sports, bookmakers and markets that we cover, the first thing you will need is an API key\ \ Get a Free API Key →\ \ \ \ To get started with the **JSON API**, see\ \ * [Odds API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html)\ \ \ To bring bookmaker odds into your website with a simple HTML tag, and to monetize with bookmaker affiliate links, checkout the [Odds Widget](https://the-odds-api.com/widget/)\ \ To get sports odds in **Excel** or **Google Sheets** at the click of a button (no coding needed), see\ \ * [Odds in Excel](https://the-odds-api.com/features/excel.html)\ \ * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) --- # Bookmaker APIs | The Odds API [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#bookmakers) Bookmakers ========================================================================================= Bookmakers are segmented by region, which can be specified in an [API request](https://the-odds-api.com/liveapi/guides/v4/) or in the add-on for [Excel](https://the-odds-api.com/features/excel.html) and [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . Regions include: * [US Bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#us-bookmakers) * [UK Bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#uk-bookmakers) * [AU Bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#au-bookmakers) * [EU Bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#eu-bookmakers) * [FR Bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#fr-bookmakers) * [SE Bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#se-bookmakers) New bookmakers are added periodically. [Suggest new bookmakers (opens new window)](https://docs.google.com/forms/d/e/1FAIpQLSfxW8riJU92gSxT3-pEaYCTx4yvB7J3hHmV6w5ZzqYLd9R11w/viewform?embedded=true&usp=pp_url&entry.454625652=New+bookmakers) . These bookmakers are covered for moneyline odds markets. [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#us-bookmakers) US Bookmakers ----------------------------------------------------------------------------------------------- The API lists odds from the following US bookmakers: | Region key | Bookmaker key | Bookmaker | Note | | --- | --- | --- | --- | | us | betonlineag | [BetOnline.ag (opens new window)](https://www.betonline.ag/) | | | us | betmgm | [BetMGM (opens new window)](https://sports.nj.betmgm.com/en/sports) | | | us | betrivers | [BetRivers (opens new window)](https://www.betrivers.com/) | | | us | betus | [BetUS (opens new window)](https://www.betus.com.pa/) | | | us | bovada | [Bovada (opens new window)](https://www.bovada.lv/) | | | us | williamhill\_us | [Caesars (opens new window)](https://www.williamhill.com/us/nj/bet/) | Only available on paid subscriptions | | us | draftkings | [DraftKings (opens new window)](https://draftkings.com/) | | | us | fanatics | [Fanatics (opens new window)](https://sportsbook.fanatics.com/) | Only available on paid subscriptions | | us | fanduel | [FanDuel (opens new window)](https://sportsbook.fanduel.com/sports) | | | us | lowvig | [LowVig.ag (opens new window)](https://www.lowvig.ag/) | | | us | mybookieag | [MyBookie.ag (opens new window)](https://mybookie.ag/) | | | us2 | ballybet | [Bally Bet (opens new window)](https://play.ballybet.com/) | | | us2 | betanysports | [BetAnything (opens new window)](https://betanything.eu/) | Formerly BetAnySports | | us2 | betparx | [betPARX (opens new window)](https://betparx.com/#home) | | | us2 | espnbet | [ESPN BET (opens new window)](https://espnbet.com/) | | | us2 | fliff | [Fliff (opens new window)](https://www.getfliff.com/) | | | us2 | hardrockbet | [Hard Rock Bet (opens new window)](https://app.hardrock.bet/) | | | us2 | rebet | [ReBet (opens new window)](https://rebet.app/) | Only available on paid subscriptions | ### [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#us-daily-fantasy-sports-dfs-sites) US Daily Fantasy Sports (DFS) Sites The API covers player props from the following US DFS sites. Odds on DFS sites can vary based on user selections, therefore odds are indicative only. | Region key | Bookmaker key | Bookmaker | Note | | --- | --- | --- | --- | | us\_dfs | betr\_us\_dfs | [Betr Picks (opens new window)](https://www.betr.app/picks) | Selections with non-default multipliers (not x1) are included in \_alternate markets | | us\_dfs | pick6 | [DraftKings Pick6 (opens new window)](https://pick6.draftkings.com/) | Selections with non-default multipliers (not x1) are included in \_alternate markets | | us\_dfs | prizepicks | [PrizePicks (opens new window)](https://prizepicks.com/) | Demons and goblins are included under \_alternate markets, for example "player\_points\_alternate".
Goblins have been assigned the default odds, demons have been assigned even odds (+100). | | us\_dfs | underdog | [Underdog Fantasy (opens new window)](https://underdogfantasy.com/) | Selections with non-default multipliers (not x1) are included in \_alternate markets | ### [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#us-exchanges) US Exchanges | Region key | Bookmaker key | Bookmaker | Note | | --- | --- | --- | --- | | us\_ex | betopenly | [BetOpenly (opens new window)](https://app.betopenly.com/) | Use the "includeBetLimits" parameter to find open bets | | us\_ex | kalshi | [Kalshi (opens new window)](https://kalshi.com/) | | | us\_ex | novig | [Novig (opens new window)](https://www.novig.us/) | | | us\_ex | prophetx | [ProphetX (opens new window)](https://www.prophetx.co/) | | [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#uk-bookmakers) UK Bookmakers ----------------------------------------------------------------------------------------------- The API lists odds from the following UK bookmakers: | Region key | Bookmaker key | Bookmaker | | --- | --- | --- | | uk | sport888 | [888sport (opens new window)](https://www.888sport.com/) | | uk | betfair\_ex\_uk | [Betfair Exchange (opens new window)](https://www.betfair.com/exchange/plus/) | | uk | betfair\_sb\_uk | [Betfair Sportsbook (opens new window)](https://www.betfair.com/) | | uk | betvictor | [Bet Victor (opens new window)](https://www.betvictor.com/) | | uk | betway | [Betway (opens new window)](https://betway.com/en/sports) | | uk | boylesports | [BoyleSports (opens new window)](https://boylesports.com/sports/) | | uk | casumo | [Casumo (opens new window)](https://casumo.com/) | | uk | coral | [Coral (opens new window)](https://sports.coral.co.uk/) | | uk | grosvenor | [Grosvenor (opens new window)](https://www.grosvenorcasinos.com/sport) | | uk | ladbrokes\_uk | [Ladbrokes (opens new window)](https://www.ladbrokes.com/) | | uk | leovegas | [LeoVegas (opens new window)](https://www.leovegas.com/en-gb/) | | uk | livescorebet | [LiveScore Bet (opens new window)](https://www.livescorebet.com/) | | uk | matchbook | [Matchbook (opens new window)](https://www.matchbook.com/) | | uk | paddypower | [Paddy Power (opens new window)](https://www.paddypower.com/) | | uk | skybet | [Sky Bet (opens new window)](https://m.skybet.com/) | | uk | smarkets | [Smarkets (opens new window)](https://smarkets.com/) | | uk | unibet\_uk | [Unibet (opens new window)](https://www.unibet.co.uk/) | | uk | virginbet | [Virgin Bet (opens new window)](https://www.virginbet.com/) | | uk | williamhill | [William Hill (UK) (opens new window)](https://www.williamhill.com/) | [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#eu-bookmakers) EU Bookmakers ----------------------------------------------------------------------------------------------- The API lists odds from the following EU bookmakers: | Region key | Bookmaker key | Bookmaker | Note | | --- | --- | --- | --- | | eu | onexbet | [1xBet (opens new window)](https://1xbet.com/) | | | eu | sport888 | [888sport (opens new window)](https://www.888sport.com/) | | | eu | betclic\_fr | [Betclic (FR) (opens new window)](https://www.betclic.com/) | | | eu | betanysports | [BetAnySports (opens new window)](https://betanysports.eu/) | | | eu | betfair\_ex\_eu | [Betfair Exchange (opens new window)](https://www.betfair.com/exchange/plus/) | | | eu | betonlineag | [BetOnline.ag (opens new window)](https://www.betonline.ag/) | | | eu | betsson | [Betsson (opens new window)](https://betsson.com/) | | | eu | codere\_it | [Codere (IT) (opens new window)](https://www.codere.it/) | | | eu | betvictor | [Bet Victor (opens new window)](https://www.betvictor.com/) | | | eu | coolbet | [Coolbet (opens new window)](https://www.coolbet.com/en/sports) | | | eu | everygame | [Everygame (opens new window)](https://everygame.eu/) | | | eu | gtbets | [GTbets (opens new window)](https://www.gtbets.ag/) | | | eu | leovegas\_se | [LeoVegas (SE) (opens new window)](https://www.leovegas.com/sv-se/betting#all-sports) | | | eu | marathonbet | [Marathon Bet (opens new window)](https://www.marathonbet.co.uk/en/) | | | eu | matchbook | [Matchbook (opens new window)](https://www.matchbook.com/) | | | eu | mybookieag | [MyBookie.ag (opens new window)](https://mybookie.ag/) | | | eu | nordicbet | [NordicBet (opens new window)](https://www.nordicbet.com/) | | | eu | parionssport\_fr | [Parions Sport (FR) (opens new window)](https://www.enligne.parionssport.fdj.fr/) | | | eu | pinnacle | [Pinnacle (opens new window)](https://www.pinnacle.com/) | Odds are from public website which may incur a delay | | eu | pmu\_fr | [PMU (FR) (opens new window)](https://parisportif.pmu.fr/) | | | eu | suprabets | [Suprabets (opens new window)](https://www.suprabets.com/) | | | eu | tipico\_de | [Tipico (DE) (opens new window)](https://sports.tipico.de/) | | | eu | unibet\_fr | [Unibet (FR) (opens new window)](https://www.unibet.fr/) | | | eu | unibet\_it | [Unibet (IT) (opens new window)](https://www.unibet.it/) | | | eu | unibet\_nl | [Unibet (NL) (opens new window)](https://www.unibet.nl/) | | | eu | unibet\_se | [Unibet (SE) (opens new window)](https://www.unibet.se/) | | | eu | williamhill | [William Hill (opens new window)](https://www.williamhill.com/) | | | eu | winamax\_de | [Winamax (DE) (opens new window)](https://www.winamax.de/) | | | eu | winamax\_fr | [Winamax (FR) (opens new window)](https://winamax.fr/) | | [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#fr-bookmakers) FR Bookmakers ----------------------------------------------------------------------------------------------- The API lists odds from the following French bookmakers. New additions of French bookmakers will be added to this region. | Region key | Bookmaker key | Bookmaker | | --- | --- | --- | | fr | betclic\_fr | [Betclic (FR) (opens new window)](https://www.betclic.com/) | | fr | netbet\_fr | [NetBet (FR) (opens new window)](https://www.netbet.fr/) | | fr | parionssport\_fr | [Parions Sport (FR) (opens new window)](https://www.enligne.parionssport.fdj.fr/) | | fr | pmu\_fr | [PMU (FR) (opens new window)](https://parisportif.pmu.fr/) | | fr | unibet\_fr | [Unibet (FR) (opens new window)](https://www.unibet.fr/) | | fr | winamax\_fr | [Winamax (FR) (opens new window)](https://winamax.fr/) | [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#se-bookmakers) SE Bookmakers ----------------------------------------------------------------------------------------------- The API lists odds from the following Swedish bookmakers. New additions of Swedish bookmakers will be added to this region. | Region key | Bookmaker key | Bookmaker | | --- | --- | --- | | se | atg\_se | [ATG (SE) (opens new window)](https://www.atg.se/sport#home) | | se | betsson | [Betsson (opens new window)](https://betsson.com/) | | se | leovegas\_se | [LeoVegas (SE) (opens new window)](https://www.leovegas.com/sv-se/betting#all-sports) | | se | mrgreen\_se | [Mr Green (SE) (opens new window)](https://www.mrgreen.se/) | | se | nordicbet | [NordicBet (opens new window)](https://www.nordicbet.com/) | | se | svenskaspel\_se | [Svenska Spel (opens new window)](https://www.svenskaspel.se/) | | se | unibet\_se | [Unibet (SE) (opens new window)](https://www.unibet.se/) | [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#au-bookmakers) AU Bookmakers ----------------------------------------------------------------------------------------------- The API lists odds from the following Australian bookmakers: | Region key | Bookmaker key | Bookmaker | Note | | --- | --- | --- | --- | | au | betfair\_ex\_au | [Betfair Exchange (opens new window)](https://www.betfair.com.au/exchange/plus/) | | | au | betr\_au | [Betr (opens new window)](https://betr.com.au/) | | | au | betright | [Bet Right (opens new window)](https://www.betright.com.au/) | | | au | bet365\_au | [Bet365 AU (opens new window)](https://www.bet365.com.au/) | Only available on paid subscriptions. Coverage currently limited to h2h, spreads and totals for AFL and NRL | | au | boombet | [BoomBet (opens new window)](https://www.boombet.com.au/) | | | au | dabble\_au | [Dabble AU (opens new window)](https://www.dabble.com.au/) | Only available on paid subscriptions | | au | ladbrokes\_au | [Ladbrokes (opens new window)](https://www.ladbrokes.com.au/) | | | au | neds | [Neds (opens new window)](https://www.neds.com.au/sports) | | | au | playup | [PlayUp (opens new window)](https://www.playup.com.au/) | | | au | pointsbetau | [PointsBet (AU) (opens new window)](https://pointsbet.com.au/) | | | au | sportsbet | [SportsBet (opens new window)](https://www.sportsbet.com.au/) | | | au | tab | [TAB (opens new window)](https://tab.com.au/) | | | au | tabtouch | [TABtouch (opens new window)](https://www.tabtouch.mobi/) | | | au | unibet | [Unibet (opens new window)](http://unibet.com.au/) | | [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#notes) Notes ------------------------------------------------------------------------------- * Some bookmakers may not list for less popular sports. Discover the bookmakers, sports and markets we cover by getting a [**free** API key](https://the-odds-api.com/#get-access) * Occasionally a bookmaker might disappear from the API response. This can happen for a number of reasons, for example, their site might be down for maintenance or they may have changed their site. These situations are usually resolved within a few hours to a few days. * We occasionally make the difficult decision to delist a bookmaker. This can be due to difficulties in maintaining their listing, or if the bookmaker removes their odds from public view. These situations are rare. [#](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#get-started) Get Started ------------------------------------------------------------------------------------------- The best way to discover the sports and bookmakers we cover is to sign up for a [free API key](https://the-odds-api.com/#get-access) . To get odds in Excel or Google Sheets at the click of a button (no coding skills needed), see * [Odds in Excel](https://the-odds-api.com/features/excel.html) * [Odds in Google Sheets](https://the-odds-api.com/features/spreadsheets.html) To get started with the JSON API, see * [API docs](https://the-odds-api.com/liveapi/guides/v4/) * [Python and NodeJS code samples](https://the-odds-api.com/liveapi/guides/v4/samples.html) --- # How to add sports odds widget to websites | The Odds API [#](https://the-odds-api.com/widget/how-to-add-odds-widget.html#how-to-add-the-odds-widget-to-websites) How to Add the Odds Widget to Websites =============================================================================================================================================== The odds widget makes it easy to display recent bookmaker odds in your website along with your own bookmaker affiliate links. Sports odds in the widget can enhance user engagement and help you monetize your website. It's quick and easy to get set up, free for small websites, and requires no coding skills. Simply [configure the HTML tag](https://the-odds-api.com/widget/v1/builder.html) and paste it into your website's HTML code. [#](https://the-odds-api.com/widget/how-to-add-odds-widget.html#monetize-your-website-with-bookmaker-affiliate-links) Monetize your website with bookmaker affiliate links --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Bookmaker odds are dynamic, relevant and engaging for users, and can increase the chance of an affiliate link click. The odds widget allows you to embed recent bookmaker odds for several sports into your website, without needing coding skills. You can also add your own affiliate links to the widget. When a user clicks your affiliate link from within the widget, it will take them to the bookmaker's website, so the bookmaker attributes the visit to you. Most bookmakers offer generous affiliate programs. The odds widget can be monetized by adding your bookmaker affiliate links to your subscription. 1. Sign up to a bookmaker's affiliate program 2. Receive a referral link, which might look something like `example-bookmaker.com/?affiliate_id=1234` 3. Add the affiliate link to your widget subscription on the [accounts page](https://the-odds-api.com/account/?path=widget-subscriptions) . When your website users click the affiliate link, the bookmaker knows those customers came from you. This can entitle you to a share of their profits. [#](https://the-odds-api.com/widget/how-to-add-odds-widget.html#bring-sports-odds-into-your-website) Bring sports odds into your website ----------------------------------------------------------------------------------------------------------------------------------------- If you have access to your website's HTML code, you can bring sports odds into your website following these steps: 1. Create a [free widget subscription](https://the-odds-api.com/account/?path=widget-subscriptions) and configure affiliate links for bookmakers you want to promote. 2. [Create the widget HTML tag](https://the-odds-api.com/widget/v1/builder.html) , including the sport, bookmaker and markets. 3. Copy and paste the widget HTML tag into your website's HTML code. [#](https://the-odds-api.com/widget/how-to-add-odds-widget.html#bring-sports-odds-into-a-wix-website) Bring sports odds into a Wix website ------------------------------------------------------------------------------------------------------------------------------------------- To bring sports odds into a [Wix](https://www.wix.com/) hosted website, follow these steps: 1. Create a [free widget subscription](https://the-odds-api.com/account/?path=widget-subscriptions) and configure affiliate links for bookmakers you want to promote. 2. [Create the widget HTML tag](https://the-odds-api.com/widget/v1/builder.html) , including the sport, bookmaker and markets. 3. Copy the url in the "src" attribute. 4. In the Wix code editor, click: Add Elements > Embed Code > Embed a site 5. Paste the widget's URL into the "website address" field ![Adding sports odds to wix](https://the-odds-api.com/assets/img/wix-1.jpg) [#](https://the-odds-api.com/widget/how-to-add-odds-widget.html#bring-sports-odds-into-a-wordpress-org-website) Bring sports odds into a WordPress.org Website --------------------------------------------------------------------------------------------------------------------------------------------------------------- 1. Create a [free widget subscription](https://the-odds-api.com/account/?path=widget-subscriptions) and configure affiliate links for bookmakers you want to promote. 2. [Create the widget HTML tag](https://the-odds-api.com/widget/v1/builder.html) , including the sport, bookmaker and markets. 3. If your website was built using [wordpress.org (opens new window)](https://wordpress.org/) , you can simply copy and paste the widget HTML tag into your website's HTML code. Alternatively, you could try using one of the many [free iframe plugins for WordPress (opens new window)](https://wordpress.org/plugins/search/iframe/) . Wordpress.org vs Wordpress.com Unlike wordpress.org, wordpress.com disallows iframe tags. The above plugins might work around this, however they can only be used on paid wordpress.com plans. [#](https://the-odds-api.com/widget/how-to-add-odds-widget.html#customizing-odds-data) Customizing Odds Data ------------------------------------------------------------------------------------------------------------- The widget is designed to make it quick and easy to bring sports odds into websites. Odds can typically be integrated into websites within minutes. This convenience comes with trade-offs, such as limited styling options. For full control over odds data on your website, integrating with [The Odds API](https://the-odds-api.com/#get-access) might better fit for your needs. This will require coding / development effort, however we try to make this as simple as possible by providing [easy documentation](https://the-odds-api.com/liveapi/guides/v4/) and [code samples (opens new window)](https://github.com/the-odds-api/) . Get started with the API for free at [The Odds API](https://the-odds-api.com/#get-access) . --- # EPL Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#epl-odds-api) EPL Odds API ======================================================================================= Get current and historical EPL odds from several bookmakers in a simple JSON API. Not a developer? Current EPL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#epl-odds-api-2) EPL Odds API ----------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current EPL odds can be queried with the following parameters: * The sport key `soccer_epl` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for 1X2) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming EPL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/soccer_epl/odds?regions=uk&markets=h2h&oddsFormat=decimal&apiKey=YOUR_API_KEY **Example Response** { "id": "0ba40aad3c918f52363117a71f5de8e8", "sport_key": "soccer_epl", "sport_title": "EPL", "commence_time": "2023-04-01T11:30:00Z", "home_team": "Manchester City", "away_team": "Liverpool", "bookmakers": [\ {\ "key": "williamhill",\ "title": "William Hill",\ "last_update": "2023-03-26T23:04:06Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-03-26T23:04:06Z",\ "outcomes": [\ { "name": "Liverpool", "price": 5.5 },\ { "name": "Manchester City", "price": 1.57 },\ { "name": "Draw", "price": 4.0 }\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#epl-bookmakers)\ EPL Bookmakers\ \ The Odds API covers EPL odds from several bookmakers, including:\ \ * **US Bookmakers:** Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more\ \ * **UK Bookmakers:** Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more\ \ * **EU Bookmakers:** 1xBet, Pinnacle, Betclic, Betsson, Unibet and more\ \ * **AU Bookmakers:** Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more\ \ \ See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#epl-markets)\ EPL Markets\ \ The Odds API covers EPL odds for several betting markets, including\ \ * 1X2\ \ * Over/Under (totals)\ \ * Half time markets\ \ * Both teams to score (BTTS)\ \ \ with more markets on the way.\ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#historical-epl-odds-data)\ Historical EPL Odds Data\ ---------------------------------------------------------------------------------------------------------------\ \ Historical EPL odds are available from mid-2020 for featured markets (moneyline, totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/epl-odds.html#more-soccer-odds)\ More Soccer Odds\ -----------------------------------------------------------------------------------------------\ \ Odds are available for several soccer leagues including\ \ * English EFL Championship\ \ * German Bundesliga\ \ * Spanish La Liga\ \ * Italian Serie A\ \ * French Ligue 1\ \ * and much more. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # MLB Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#mlb-odds-api) MLB Odds API ======================================================================================= Get current and historical MLB odds from several bookmakers in a simple JSON API. Not a developer? Current MLB odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#mlb-odds-api-2) MLB Odds API ----------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current MLB odds can be queried with the following parameters: * The sport key `baseball_mlb` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming MLB games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/baseball_mlb/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "5c4d8f368956b33f3f2639aed5152e2f",\ "sport_key": "baseball_mlb",\ "sport_title": "MLB",\ "commence_time": "2023-07-19T01:40:00Z",\ "home_team": "Seattle Mariners",\ "away_team": "Minnesota Twins",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-07-18T03:56:37Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-07-18T03:56:37Z",\ "outcomes": [\ {"name": "Minnesota Twins", "price": 105},\ {"name": "Seattle Mariners", "price": -125}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2023-07-18T03:56:37Z",\ "outcomes": [\ {"name": "Minnesota Twins", "price": -200, "point": 1.5},\ {"name": "Seattle Mariners", "price": 170, "point": -1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2023-07-18T03:56:37Z",\ "outcomes": [\ {"name": "Over", "price": -110, "point": 7.5},\ {"name": "Under", "price": -110, "point": 7.5}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#mlb-bookmakers)\ MLB Bookmakers\ \ The Odds API covers MLB odds from several bookmakers, including:\ \ * **US Bookmakers:** Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more\ \ * **UK Bookmakers:** Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more\ \ * **EU Bookmakers:** 1xBet, Pinnacle, Betclic, Betsson, Unibet and more\ \ * **AU Bookmakers:** Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more\ \ \ See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#mlb-markets)\ MLB Markets\ \ The Odds API covers MLB odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * Innings odds (for example, 1st 5 innings moneyline, spreads and totals)\ \ * [MLB player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#mlb-player-props-api)\ (US and AU bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#historical-mlb-odds-data)\ Historical MLB Odds Data\ ---------------------------------------------------------------------------------------------------------------\ \ Historical MLB odds are available from mid-2020 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/mlb-odds.html#more-odds)\ More Odds\ ---------------------------------------------------------------------------------\ \ Odds are available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # NCAA Basketball Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#ncaa-basketball-odds-api) NCAA Basketball Odds API =========================================================================================================================== Get current and historical NCAA basketball odds from several bookmakers in a simple JSON API. Not a developer? Current NCAA basketball odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#ncaa-basketball-odds-api-2) NCAA Basketball Odds API ----------------------------------------------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current NCAA basketball odds can be queried with the following parameters: * The sport key `basketball_ncaab` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming NCAA basketball games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/basketball_ncaab/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "c2c1443efd1751ffa821931adb3ec450",\ "sport_key": "basketball_ncaab",\ "sport_title": "NCAAB",\ "commence_time": "2023-02-01T00:00:00Z",\ "home_team": "Duke Blue Devils",\ "away_team": "Wake Forest Demon Deacons",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-01-31T23:55:09Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-01-31T23:55:09Z",\ "outcomes": [\ {"name": "Duke Blue Devils", "price": -365},\ {"name": "Wake Forest Demon Deacons", "price": 300}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2023-01-31T23:55:09Z",\ "outcomes": [\ {"name": "Duke Blue Devils", "price": -110, "point": -8.0},\ {"name": "Wake Forest Demon Deacons", "price": -110, "point": 8.0}\ ]\ },\ {\ "key": "totals",\ "last_update": "2023-01-31T23:55:09Z",\ "outcomes": [\ {"name": "Over", "price": -110, "point": 147.5},\ {"name": "Under", "price": -110, "point": 147.5}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#ncaa-basketball-bookmakers)\ NCAA Basketball Bookmakers\ \ The Odds API covers NCAA basketball odds from several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#ncaa-basketball-markets)\ NCAA Basketball Markets\ \ The Odds API covers NCAA basketball odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * [NCAA basketball player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#nba-ncaab-wnba-player-props-api)\ (US bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#historical-ncaa-basketball-odds-data)\ Historical NCAA Basketball Odds Data\ ---------------------------------------------------------------------------------------------------------------------------------------------------\ \ Historical NCAA Basketball odds are available from late 2020 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/ncaa-basketball-odds.html#more-basketball-odds)\ More Basketball Odds\ -------------------------------------------------------------------------------------------------------------------\ \ Odds are available for other basketball leagues including\ \ * NBA\ \ * WNBA\ \ * Euroleague\ \ \ Odds are also available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # NBA Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#nba-odds-api) NBA Odds API ======================================================================================= Get current and historical NBA odds from several bookmakers in a simple JSON API. Not a developer? Current NBA odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#nba-odds-api-2) NBA Odds API ----------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current NBA odds can be queried with the following parameters: * The sport key `basketball_nba` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming NBA games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/basketball_nba/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "4f88be957c08fec11f1a32985c4e0ca4",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2023-02-01T00:10:00Z",\ "home_team": "Cleveland Cavaliers",\ "away_team": "Miami Heat",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-01-31T23:55:27Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-01-31T23:55:27Z",\ "outcomes": [\ {"name": "Cleveland Cavaliers", "price": -165},\ {"name": "Miami Heat", "price": 140}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2023-01-31T23:55:27Z",\ "outcomes": [\ {"name": "Cleveland Cavaliers", "price": -110, "point": -4.0},\ {"name": "Miami Heat", "price": -110, "point": 4.0}\ ]\ },\ {\ "key": "totals",\ "last_update": "2023-01-31T23:55:27Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 211.0},\ {"name": "Under", "price": -115, "point": 211.0}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#nba-bookmakers)\ NBA Bookmakers\ \ The Odds API covers NBA odds from several bookmakers, including:\ \ * **US Bookmakers:** Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more\ \ * **UK Bookmakers:** Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more\ \ * **EU Bookmakers:** 1xBet, Pinnacle, Betclic, Betsson, Unibet and more\ \ * **AU Bookmakers:** Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more\ \ \ See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#nba-markets)\ NBA Markets\ \ The Odds API covers NBA odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * Quarter time and half time odds\ \ * [NBA player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#nba-ncaab-wnba-player-props-api)\ (US and AU bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#historical-nba-odds-data)\ Historical NBA Odds Data\ ---------------------------------------------------------------------------------------------------------------\ \ Historical NBA odds are available from mid-2020 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/nba-odds.html#more-basketball-odds)\ More Basketball Odds\ -------------------------------------------------------------------------------------------------------\ \ Odds are available for other basketball leagues including\ \ * NCAA\ \ * WNBA\ \ * Euroleague\ \ \ Odds are also available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # NHL Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#nhl-odds-api) NHL Odds API ======================================================================================= Get current and historical NHL odds from several bookmakers in a simple JSON API. Not a developer? Current NHL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#nhl-odds-api-2) NHL Odds API ----------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current NHL odds can be queried with the following parameters: * The sport key `icehockey_nhl` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming NHL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/icehockey_nhl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "4a5b991dcc0cdd71b240d6fc7c7215e6",\ "sport_key": "icehockey_nhl",\ "sport_title": "NHL",\ "commence_time": "2023-02-01T00:00:00Z",\ "home_team": "Carolina Hurricanes",\ "away_team": "Los Angeles Kings",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-01-31T23:55:18Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-01-31T23:55:18Z",\ "outcomes": [\ {"name": "Carolina Hurricanes", "price": -205},\ {"name": "Los Angeles Kings", "price": 175}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2023-01-31T23:55:18Z",\ "outcomes": [\ {"name": "Carolina Hurricanes", "price": 125, "point": -1.5},\ {"name": "Los Angeles Kings", "price": -145, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2023-01-31T23:55:18Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 6.0},\ {"name": "Under", "price": -115, "point": 6.0}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#nhl-bookmakers)\ NHL Bookmakers\ \ The Odds API covers NHL odds from several bookmakers, including:\ \ * **US Bookmakers:** Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more\ \ * **UK Bookmakers:** Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more\ \ * **EU Bookmakers:** 1xBet, Pinnacle, Betclic, Betsson, Unibet and more\ \ * **AU Bookmakers:** Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more\ \ \ See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#nhl-markets)\ NHL Markets\ \ The Odds API covers NHL odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * Game period odds\ \ * [NHL player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#nhl-player-props-api)\ (US bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#historical-nhl-odds-data)\ Historical NHL Odds Data\ ---------------------------------------------------------------------------------------------------------------\ \ Historical NHL odds are available from late 2020 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/nhl-odds.html#more-odds)\ More Odds\ ---------------------------------------------------------------------------------\ \ Odds are available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # UFC - MMA Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#ufc-mma-odds-api) UFC - MMA Odds API ================================================================================================= Get current and historical MMA odds from several bookmakers in a simple JSON API. Not a developer? Current MMA odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#ufc-mma-odds-api-2) UFC - MMA Odds API --------------------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current MMA odds can be queried with the following parameters: * The sport key `mma_mixed_martial_arts` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for fight winner) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming MMA games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/mma_mixed_martial_arts/odds?regions=us&markets=h2h&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "684c6d98c0e3e7dab04a54b31e78d05d",\ "sport_key": "mma_mixed_martial_arts",\ "sport_title": "MMA",\ "commence_time": "2023-07-22T17:50:00Z",\ "home_team": "Michael Parkin",\ "away_team": "Jamal Pogues",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2023-07-18T04:46:01Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-07-18T04:46:01Z",\ "outcomes": [\ {"name": "Jamal Pogues", "price": -150},\ {"name": "Michael Parkin", "price": 130}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#ufc-mma-bookmakers)\ UFC - MMA Bookmakers\ \ The Odds API covers MMA odds from several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#ufc-mma-markets)\ UFC - MMA Markets\ \ The Odds API currently covers MMA fight winner odds, with more markets on the way. See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#historical-ufc-mma-odds-data)\ Historical UFC - MMA Odds Data\ -------------------------------------------------------------------------------------------------------------------------\ \ Historical MMA odds are available from mid-2020. Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/mma-odds.html#more-odds)\ More Odds\ ---------------------------------------------------------------------------------\ \ Odds are available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # WNBA Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#wnba-odds-api) WNBA Odds API ========================================================================================== Get current and historical WNBA odds from several bookmakers in a simple JSON API. Not a developer? Current WNBA odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#wnba-odds-api-2) WNBA Odds API -------------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current WNBA odds can be queried with the following parameters: * The sport key `basketball_wnba` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming WNBA games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/basketball_wnba/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "4f7245f44b01c54ba74d805cb12cc3ef",\ "sport_key": "basketball_wnba",\ "sport_title": "WNBA",\ "commence_time": "2023-07-18T23:00:00Z",\ "home_team": "Atlanta Dream",\ "away_team": "Minnesota Lynx",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2023-07-18T03:51:57Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-07-18T03:51:57Z",\ "outcomes": [\ {"name": "Atlanta Dream", "price": -280},\ {"name": "Minnesota Lynx", "price": 215}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2023-07-18T03:51:57Z",\ "outcomes": [\ {"name": "Atlanta Dream", "price": -106, "point": -6.5},\ {"name": "Minnesota Lynx", "price": -120, "point": 6.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2023-07-18T03:51:57Z",\ "outcomes": [\ {"name": "Over", "price": -115, "point": 170.5 },\ {"name": "Under", "price": -111, "point": 170.5}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#wnba-bookmakers)\ WNBA Bookmakers\ \ The Odds API covers WNBA odds from several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#wnba-markets)\ WNBA Markets\ \ The Odds API covers WNBA odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * [WNBA player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#nba-ncaab-wnba-player-props-api)\ (US bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#historical-wnba-odds-data)\ Historical WNBA Odds Data\ ------------------------------------------------------------------------------------------------------------------\ \ Historical WNBA odds are available from mid-2022 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#get-started)\ Get Started\ --------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/wnba-odds.html#more-basketball-odds)\ More Basketball Odds\ --------------------------------------------------------------------------------------------------------\ \ Odds are available for other basketball leagues including\ \ * NBA\ \ * NCAA\ \ * Euroleague\ \ \ Odds are also available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # NCAA Football Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#ncaa-football-odds-api) NCAA Football Odds API ===================================================================================================================== Get current and historical NCAA football odds from several bookmakers in a simple JSON API. Not a developer? Current NCAA football odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#ncaa-football-odds-api-2) NCAA Football Odds API ----------------------------------------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current NCAA football odds can be queried with the following parameters: * The sport key `americanfootball_ncaaf` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming NCAA football games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/americanfootball_ncaaf/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "a6a6892034f3b351cedfb5a5f5c48386",\ "sport_key": "americanfootball_ncaaf",\ "sport_title": "NCAAF",\ "commence_time": "2022-12-02T18:00:00Z",\ "home_team": "Buffalo Bulls",\ "away_team": "Akron Zips",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2022-11-30T23:54:50Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2022-11-30T23:54:50Z",\ "outcomes": [\ {"name": "Akron Zips", "price": 350},\ {"name": "Buffalo Bulls", "price": -435}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2022-11-30T23:54:50Z",\ "outcomes": [\ {"name": "Akron Zips", "price": -110, "point": 11.5},\ {"name": "Buffalo Bulls", "price": -110, "point": -11.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2022-11-30T23:54:50Z",\ "outcomes": [\ {"name": "Over", "price": -110, "point": 55.0},\ {"name": "Under", "price": -110, "point": 55.0}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#ncaa-football-bookmakers)\ NCAA football Bookmakers\ \ The Odds API covers NCAA football odds from several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#ncaa-football-markets)\ NCAA football Markets\ \ The Odds API covers NCAA football odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * Quarter time and half time odds\ \ * [NCAA football player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#nfl-player-props-api)\ (US bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#historical-ncaa-football-odds-data)\ Historical NCAA football Odds Data\ ---------------------------------------------------------------------------------------------------------------------------------------------\ \ Historical NCAA football odds are available from mid-2020 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#get-started)\ Get Started\ -----------------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/ncaa-football-odds.html#more-football-odds)\ More Football Odds\ -------------------------------------------------------------------------------------------------------------\ \ Odds are available for other football leagues including\ \ * NFL\ \ * XFL\ \ * CFL\ \ * AFL\ \ \ Odds are also available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # AHL Odds API | The Odds API [#](https://the-odds-api.com/sports/ahl-odds.html#ahl-odds-api) AHL Odds API ============================================================================= The Odds API covers AHL (American Hockey League) odds for live and upcoming games in a simple JSON API. Not a developer? Current AHL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/ahl-odds.html#features) Features --------------------------------------------------------------------- * AHL odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical AHL odds data is available from Feb 2025 on paid usage plans. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/ahl-odds.html#querying-ahl-odds) Querying AHL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/ahl-odds.html#query-featured-ahl-markets) Query Featured AHL Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current AHL odds for featured markets, the following parameters need to be provided: * **sport**   In this case `icehockey_ahl` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/icehockey_ahl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming AHL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "b8118236a243dc0fbcc08254162185af",\ "sport_key": "icehockey_ahl",\ "sport_title": "AHL",\ "commence_time": "2025-02-20T00:00:00Z",\ "home_team": "Utica Comets",\ "away_team": "Belleville Senators",\ "bookmakers": [{\ "key": "betrivers",\ "title": "BetRivers",\ "last_update": "2025-02-19T12:19:38Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-02-19T12:19:38Z",\ "outcomes": [\ {"name": "Belleville Senators", "price": -120},\ {"name": "Utica Comets", "price": -117}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-02-19T12:19:38Z",\ "outcomes": [\ {"name": "Belleville Senators", "price": 220, "point": -1.5},\ {"name": "Utica Comets", "price": -335, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-02-19T12:19:38Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 5.5},\ {"name": "Under", "price": -132, "point": 5.5}\ ]\ }]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ For ice hockey, the `h2h` market currently displays the market that is featured on each bookmaker's website (the market shown on a bookmaker's main events page). EU bookmakers typically feature regular time odds (includes draw), whilst US bookmakers typically feature the overtime odds (excludes draw).\ \ [#](https://the-odds-api.com/sports/ahl-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/ahl-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # Boxing Odds API | The Odds API [#](https://the-odds-api.com/sports/boxing-odds.html#boxing-odds-api) Boxing Odds API ====================================================================================== The Odds API covers boxing odds for live and upcoming bouts in a simple JSON API. Not a developer? Current boxing odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/boxing-odds.html#features) Features ------------------------------------------------------------------------ * Boxing odds are covered for live and upcoming bouts. * Fight winner is covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . Limited coverage of total rounds odds are also available from some bookmakers. * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical boxing odds data is available from May 2023 on paid usage plans. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/boxing-odds.html#querying-boxing-odds) Querying Boxing Odds ------------------------------------------------------------------------------------------------ ### [#](https://the-odds-api.com/sports/boxing-odds.html#query-featured-boxing-markets) Query Featured Boxing Markets Featured markets (fight winner and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current boxing odds for featured markets, the following parameters need to be provided: * **sport**   In this case `boxing_boxing` * **regions**   Regions of bookmakers to return, for example, `us`, `uk` and `eu` * **markets**   For example, `h2h` for fight winner * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) * **oddsFormat**   This parameter is optional, and can be used to return odds in American format (`oddsFormat=american`). By default, odds will return in decimal format. See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/boxing_boxing/odds?regions=us,uk,eu&markets=h2h&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming boxing bouts, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "68e59b2288e928826647e6a07e706958",\ "sport_key": "boxing_boxing",\ "sport_title": "Boxing",\ "commence_time": "2025-03-01T21:00:00Z",\ "home_team": "Craig Richards",\ "away_team": "Padraig McCrory",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2025-02-23T01:04:39Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-02-23T01:04:38Z",\ "outcomes": [\ // to see odds in American format, add &oddsFormat=american to the request URL\ {"name": "Craig Richards", "price": 1.56},\ {"name": "Padraig McCrory", "price": 2.4}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 1 x 3 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/boxing-odds.html#other-sports)\ Other Sports\ --------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/boxing-odds.html#stay-updated)\ Stay Updated\ --------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # MMA/UFC Odds API | The Odds API [#](https://the-odds-api.com/sports/mma-ufc-odds.html#mma-ufc-odds-api) MMA/UFC Odds API ========================================================================================= The Odds API covers MMA/UFC odds for live and upcoming fights in a simple JSON API. Not a developer? Current MMA/UFC odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/mma-ufc-odds.html#features) Features ------------------------------------------------------------------------- * MMA/UFC odds are covered for live and upcoming fights. * Fight winner is covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . Limited coverage of total rounds odds are also available from some bookmakers. * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical MMA/UFC odds data is available from June 2020 on paid usage plans. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/mma-ufc-odds.html#querying-mma-ufc-odds) Querying MMA/UFC Odds --------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/mma-ufc-odds.html#query-featured-mma-ufc-markets) Query Featured MMA/UFC Markets Featured markets (fight winner and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current MMA/UFC odds for featured markets, the following parameters need to be provided: * **sport**   In this case `mma_mixed_martial_arts` * **regions**   Regions of bookmakers to return, for example, `us`, `uk` and `eu` * **markets**   For example, `h2h` for fight winner * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) * **oddsFormat**   This parameter is optional, and can be used to return odds in American format (`oddsFormat=american`). By default, odds will return in decimal format. See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/mma_mixed_martial_arts/odds?regions=us,uk,eu&markets=h2h&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming fights, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "e46e328f688ff096aca6e5bb4ac96bbc",\ "sport_key": "mma_mixed_martial_arts",\ "sport_title": "MMA",\ "commence_time": "2025-12-31T22:59:00Z",\ "home_team": "Max Holloway",\ "away_team": "Alex Volkanovski",\ "bookmakers": [\ {\ "key": "unibet_uk",\ "title": "Unibet",\ "last_update": "2025-02-25T23:07:18Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-02-25T23:07:18Z",\ "outcomes": [\ // to see odds in American format, add &oddsFormat=american to the request URL\ {"name": "Alex Volkanovski", "price": 1.6},\ {"name": "Max Holloway", "price": 2.3}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 1 x 3 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/mma-ufc-odds.html#other-sports)\ Other Sports\ ---------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/mma-ufc-odds.html#stay-updated)\ Stay Updated\ ---------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NCAA Lacrosse Odds API | The Odds API [#](https://the-odds-api.com/sports/ncaa-lacrosse-odds.html#ncaa-lacrosse-odds-api) NCAA Lacrosse Odds API =========================================================================================================== The Odds API covers NCAA lacrosse odds for live and upcoming games in a simple JSON API. Not a developer? Current NCAA lacrosse odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/ncaa-lacrosse-odds.html#features) Features ------------------------------------------------------------------------------- * NCAA lacrosse odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets such as player props are not currently offered by bookmakers for NCAA lacrosse. If this situation changes in future, these markets will be added to the API. * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NCAA lacrosse odds data is available on paid usage plans, available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/ncaa-lacrosse-odds.html#querying-ncaa-lacrosse-odds) Querying NCAA Lacrosse Odds --------------------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/ncaa-lacrosse-odds.html#query-featured-ncaa-lacrosse-markets) Query Featured NCAA Lacrosse Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current NCAA lacrosse odds for featured markets, the following parameters need to be provided: * **sport**   In this case `lacrosse_ncaa` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/lacrosse_ncaa/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NCAA lacrosse games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "34fe098c735e6e6b26937ac1c95a0e57",\ "sport_key": "lacrosse_ncaa",\ "sport_title": "NCAA Lacrosse",\ "commence_time": "2025-02-22T16:00:00Z",\ "home_team": "Denver Pioneers",\ "away_team": "Cornell Big Red",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2025-02-19T23:35:08Z",\ "markets": [{\ "key": "h2h",\ "last_update": "2025-02-19T23:35:08Z",\ "outcomes": [\ {"name": "Cornell Big Red", "price": -650},\ {"name": "Denver Pioneers", "price": 440}\ ]},\ {\ "key": "spreads",\ "last_update": "2025-02-19T23:35:08Z",\ "outcomes": [\ {"name": "Cornell Big Red", "price": -110, "point": -4.5},\ {"name": "Denver Pioneers", "price": -110, "point": 4.5}\ ]},\ {\ "key": "totals",\ "last_update": "2025-02-19T23:35:08Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 24.5},\ {"name": "Under", "price": -115, "point": 24.5}\ ]}\ ]},\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/ncaa-lacrosse-odds.html#other-sports)\ Other Sports\ ---------------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/ncaa-lacrosse-odds.html#stay-updated)\ Stay Updated\ ---------------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # Odds Widget Builder V1 | The Odds API [#](https://the-odds-api.com/widget/v1/builder.html#odds-widget-builder-v1) Odds Widget Builder V1 =================================================================================================== The odds widget lets you add recent bookmaker odds to websites using a simple HTML tag and your own bookmaker affiliate links (no coding needed). ### HTML Tag Builder Access Key Get a free access key by [creating an account](https://the-odds-api.com/account/?path=widget-subscriptions) You can also set affiliate links for the bookmakers that you wish to display Sport Show live and upcoming games for this sport American Football: CFL American Football: NCAAF American Football: NCAAF Championship Winner American Football: NFL American Football: NFL Preseason American Football: NFL Super Bowl Winner American Football: UFL Aussie Rules: AFL Baseball: MLB Baseball: MLB Preseason Baseball: MLB World Series Winner Baseball: Minor League Baseball Baseball: NPB Baseball: KBO League Baseball: NCAA Baseball Basketball: Basketball Euroleague Basketball: NBA Basketball: NBA Preseason Basketball: NBA Summer League Basketball: NBA Championship Winner Basketball: WNBA Basketball: NCAAB Basketball: WNCAAB Basketball: NCAAB Championship Winner Basketball: NBL (Australia) Boxing: Boxing Cricket: Asia Cup Cricket: Big Bash Cricket: Caribbean Premier League Cricket: ICC Champions Trophy Cricket: ICC World Cup Cricket: ICC Women's World Cup Cricket: International Twenty20 Cricket: IPL Cricket: One Day Internationals Cricket: Pakistan Super League Cricket: T20 Blast Cricket: Test Matches Cricket: The Hundred Golf: Masters Tournament Winner Golf: PGA Championship Winner Golf: The Open Winner Golf: US Open Winner Handball: Handball-Bundesliga Ice Hockey: NHL Ice Hockey: NHL Preseason Ice Hockey: AHL Ice Hockey: NHL Championship Winner Ice Hockey: Finnish Liiga Ice Hockey: Finnish Mestis Ice Hockey: SHL Ice Hockey: HockeyAllsvenskan Lacrosse: Premier Lacrosse League Lacrosse: NCAA Lacrosse Mixed Martial Arts: MMA Politics: US Presidential Elections Winner Rugby League: NRL Rugby League: NRL State of Origin Rugby Union: Six Nations Soccer: Africa Cup of Nations Soccer: Primera División - Argentina Soccer: A-League Soccer: Austrian Football Bundesliga Soccer: Belgium First Div Soccer: Brazil Série A Soccer: Brazil Série B Soccer: Primera División - Chile Soccer: Super League - China Soccer: Denmark Superliga Soccer: Championship Soccer: EFL Cup Soccer: League 1 Soccer: League 2 Soccer: EPL Soccer: FA Cup Soccer: FIFA World Cup Soccer: FIFA World Cup Qualifiers - Europe Soccer: FIFA World Cup Qualifiers - South America Soccer: FIFA Women's World Cup Soccer: FIFA World Cup Winner Soccer: FIFA Club World Cup Soccer: Veikkausliiga - Finland Soccer: Ligue 1 - France Soccer: Ligue 2 - France Soccer: Bundesliga - Germany Soccer: Bundesliga 2 - Germany Soccer: 3. Liga - Germany Soccer: Super League - Greece Soccer: Serie A - Italy Soccer: Serie B - Italy Soccer: J League Soccer: K League 1 Soccer: League of Ireland Soccer: Liga MX Soccer: Dutch Eredivisie Soccer: Eliteserien - Norway Soccer: Ekstraklasa - Poland Soccer: Primeira Liga - Portugal Soccer: Premier League - Russia Soccer: La Liga - Spain Soccer: La Liga 2 - Spain Soccer: Premiership - Scotland Soccer: Allsvenskan - Sweden Soccer: Superettan - Sweden Soccer: Swiss Superleague Soccer: Turkey Super League Soccer: UEFA Europa Conference League Soccer: UEFA Champions League Soccer: UEFA Champions League Qualification Soccer: UEFA Women's Champions League Soccer: UEFA Europa League Soccer: UEFA Euro 2024 Soccer: UEFA Euro Qualification Soccer: UEFA Nations League Soccer: CONCACAF Gold Cup Soccer: CONCACAF Leagues Cup Soccer: Copa América Soccer: Copa Libertadores Soccer: Copa Sudamericana Soccer: MLS Tennis: ATP Australian Open Tennis: ATP Canadian Open Tennis: ATP China Open Tennis: ATP Cincinnati Open Tennis: ATP Dubai Championships Tennis: ATP French Open Tennis: ATP Indian Wells Tennis: ATP Italian Open Tennis: ATP Madrid Open Tennis: ATP Miami Open Tennis: ATP Monte-Carlo Masters Tennis: ATP Paris Masters Tennis: ATP Qatar Open Tennis: ATP Shanghai Masters Tennis: ATP US Open Tennis: ATP Wimbledon Tennis: WTA Australian Open Tennis: WTA Canadian Open Tennis: WTA China Open Tennis: WTA Cincinnati Open Tennis: WTA Dubai Championships Tennis: WTA French Open Tennis: WTA Indian Wells Tennis: WTA Italian Open Tennis: WTA Madrid Open Tennis: WTA Miami Open Tennis: WTA Qatar Open Tennis: WTA US Open Tennis: WTA Wimbledon Tennis: WTA Wuhan Open Bookmaker The bookmaker whose odds are to be displayed, along with your affiliate link BetOnline.ag BetMGM BetRivers BetUS Bovada Caesars DraftKings Fanatics FanDuel LowVig.ag MyBookie.ag Bally Bet BetAnything betPARX ESPN BET Fliff Hard Rock Bet ReBet 888sport Betfair Exchange Betfair Sportsbook Bet Victor Betway BoyleSports Casumo Coral Grosvenor Ladbrokes LeoVegas LiveScore Bet Matchbook Paddy Power Sky Bet Smarkets Unibet Virgin Bet William Hill (UK) 1xBet 888sport Betclic (FR) BetAnySports Betfair Exchange BetOnline.ag Betsson Codere (IT) Bet Victor Coolbet Everygame GTbets LeoVegas (SE) Marathon Bet Matchbook MyBookie.ag NordicBet Parions Sport (FR) Pinnacle PMU (FR) Suprabets Tipico (DE) Unibet (FR) Unibet (IT) Unibet (NL) Unibet (SE) William Hill Winamax (DE) Winamax (FR) Betfair Exchange Betr Bet Right Bet365 AU BoomBet Dabble AU Ladbrokes Neds PlayUp PointsBet (AU) SportsBet TAB TABtouch Unibet Odds Format American Decimal Markets Click and drag, or shift + click to select multiple h2h (head-to-head, moneyline, 1x2...) spreads (handicap) totals (over/under) Custom Market Names Override the names of the markets to suit the sport or the region of your users h2h: spreads: totals: ### Preview HTML Tag Copy and paste into your website's HTML code `` Feedback We'd love to hear your thoughts on the widget, including usability, new feature requests, bugs, latency, and pricing feedback. Contact us at [team@the-odds-api.com](mailto:team@the-odds-api.com?subject=Widget%20Feedback) For more info on the widget, [check out the docs](https://the-odds-api.com/widget/v1/) --- # NFL Odds API | The Odds API [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#nfl-odds-api) NFL Odds API ======================================================================================= Get current and historical NFL odds from several bookmakers in a simple JSON API. Not a developer? Current NFL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#nfl-odds-api-2) NFL Odds API ----------------------------------------------------------------------------------------- Once you have your [API key](https://the-odds-api.com/#get-access) , current NFL odds can be queried with the following parameters: * The sport key `americanfootball_nfl` * The regions of desired bookmakers (us, us2, uk, eu or au) * Markets (h2h for moneyline, spreads or totals) * Odds format (decimal or American) * And your API key ([get a free API key](https://the-odds-api.com/#get-access) ) The API will return live and upcoming NFL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. **Example Request** GET https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example Response** [{\ "id": "42db668449664943833b5c04a583328a",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2023-09-08T00:21:00Z",\ "home_team": "Kansas City Chiefs",\ "away_team": "Detroit Lions",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2023-07-18T07:38:01Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2023-07-18T07:38:01Z",\ "outcomes": [\ {"name": "Detroit Lions", "price": 245},\ {"name": "Kansas City Chiefs", "price": -300}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2023-07-18T07:38:01Z",\ "outcomes": [\ {"name": "Detroit Lions", "price": -105, "point": 6.5},\ {"name": "Kansas City Chiefs", "price": -115, "point": -6.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2023-07-18T07:38:01Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 54.5},\ {"name": "Under", "price": -115, "point": 54.5}\ ]\ }\ ]\ },\ ...\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for more details.\ \ ### [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#nfl-bookmakers)\ NFL Bookmakers\ \ The Odds API covers NFL odds from several bookmakers, including:\ \ * **US Bookmakers:** Draftkings, Fanduel, FoxBet, BetMGM, Caesars, Bovada, and more\ \ * **UK Bookmakers:** Unibet, William Hill, Ladbrokes, Betfair, Bet Victor, Paddy Power and more\ \ * **EU Bookmakers:** 1xBet, Pinnacle, Betclic, Betsson, Unibet and more\ \ * **AU Bookmakers:** Sportsbet, TAB, Neds, Ladbrokes, Betfair, Unibet and more\ \ \ See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)\ \ ### [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#nfl-markets)\ NFL Markets\ \ The Odds API covers NFL odds for several betting markets, including\ \ * Moneyline\ \ * Spreads (handicap)\ \ * Over/Under (totals)\ \ * Quarter time and half time odds\ \ * [NFL player props](https://the-odds-api.com/sports-odds-data/betting-markets.html#nfl-player-props-api)\ (US and AU bookmakers only)\ \ \ See the full list of [betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html)\ .\ \ ### [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#latency)\ Latency\ \ More information on odds latencies can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#historical-nfl-odds-data)\ Historical NFL Odds Data\ ---------------------------------------------------------------------------------------------------------------\ \ Historical NFL odds are available from mid-2020 for featured markets (moneyline, spreads and totals). Learn more about [historical odds data](https://the-odds-api.com/historical-odds-data/)\ , or see [the docs](https://the-odds-api.com/liveapi/guides/v4/#get-historical-odds)\ .\ \ [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#get-started)\ Get Started\ -------------------------------------------------------------------------------------\ \ * Get a [free API key](https://the-odds-api.com/#get-access)\ \ * Check out the [API docs](https://the-odds-api.com/liveapi/guides/v4/)\ \ * Check out [Python and NodeJS code samples (opens new window)](https://github.com/the-odds-api/)\ \ \ [#](https://the-odds-api.com/sports-odds-data/nfl-odds.html#more-football-odds)\ More Football Odds\ ---------------------------------------------------------------------------------------------------\ \ Odds are available for other football leagues including\ \ * NCAA\ \ * XFL\ \ * CFL\ \ * AFL\ \ \ Odds are also available for a wide range of sports. See the full list of [available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ . --- # AFL Odds API | The Odds API [#](https://the-odds-api.com/sports/afl-odds.html#afl-odds-api) AFL Odds API ============================================================================= The Odds API covers AFL odds for live and upcoming games in a simple JSON API. Not a developer? Current AFL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/afl-odds.html#features) Features --------------------------------------------------------------------- * AFL odds are covered for live and upcoming games. * Featured markets, including head-to-head, handicap, over/under are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#au-bookmakers) . * Additional markets including player props, quarter and half time markets, and more are covered for most AU bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * AFL scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical AFL odds data is available on paid usage plans. Historical odds for featured markets (head-to-head, handicap, over/under) are available from mid-2020. Historical odds for other markets are available from mid-2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/afl-odds.html#querying-afl-odds) Querying AFL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/afl-odds.html#query-featured-afl-markets) Query Featured AFL Markets Featured markets (head-to-head, handicap and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current AFL odds for featured markets, the following parameters need to be provided: * **sport**   In this case `aussierules_afl` * **regions**   Regions of bookmakers to return, for example `au` * **markets**   For example, `h2h` for head-to-head, `spreads` for handicap, and `totals` for over/under * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/aussierules_afl/odds?regions=au&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming AFL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "42e281a1a490751d30ba951bfcaefd76",\ "sport_key": "aussierules_afl",\ "sport_title": "AFL",\ "commence_time": "2025-04-17T09:30:00Z",\ "home_team": "Brisbane Lions",\ "away_team": "Collingwood Magpies",\ "bookmakers": [\ {\ "key": "sportsbet",\ "title": "SportsBet",\ "last_update": "2025-04-16T04:29:44Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-04-16T04:29:44Z",\ "outcomes": [\ {"name": "Brisbane Lions", "price": 1.53},\ {"name": "Collingwood Magpies", "price": 2.51}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-04-16T04:29:44Z",\ "outcomes": [\ {"name": "Brisbane Lions", "price": 1.9, "point": -10.5},\ {"name": "Collingwood Magpies", "price": 1.9, "point": 10.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-04-16T04:29:44Z",\ "outcomes": [\ {"name": "Over", "price": 1.88, "point": 175.5},\ {"name": "Under", "price": 1.88, "point": 175.5}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/afl-odds.html#query-any-afl-market)\ Query Any AFL Market\ \ Any supported AFL markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current AFL odds for any market, including player props, half and quarter time markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `aussierules_afl`\ * **eventId**   This example uses the id of Brisbane Lions v Collingwood Magpies (id 42e28...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `au`\ * **markets**   For example `h2h_q1` (1st quarter head-to-head), `player_disposals`, `player_goal_scorer_anytime`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/aussierules_afl/events/42e281a1a490751d30ba951bfcaefd76/odds?regions=au&markets=h2h_q1,player_disposals,player_goal_scorer_anytime&oddsFormat=decimal&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified AFL game including odds from the specified bookmakers and markets.\ \ {\ "id": "42e281a1a490751d30ba951bfcaefd76",\ "sport_key": "aussierules_afl",\ "sport_title": "AFL",\ "commence_time": "2025-04-17T09:30:00Z",\ "home_team": "Brisbane Lions",\ "away_team": "Collingwood Magpies",\ "bookmakers": [\ {\ "key": "ladbrokes_au",\ "title": "Ladbrokes",\ "markets": [\ {\ "key": "h2h_q1",\ "last_update": "2025-04-16T04:40:00Z",\ "outcomes": [\ {"name": "Brisbane Lions", "price": 1.7},\ {"name": "Collingwood Magpies", "price": 2.15}\ ]\ },\ {\ "key": "player_goal_scorer_anytime",\ "last_update": "2025-04-16T04:40:00Z",\ "outcomes": [\ {"name": "Yes", "description": "Eric Hipwood", "price": 1.1},\ {"name": "Yes", "description": "Logan Morris", "price": 1.12},\ ...\ ]\ },\ {\ "key": "player_goals_scored_over",\ "last_update": "2025-04-16T04:40:00Z",\ "outcomes": [\ {"name": "Over", "description": "Eric Hipwood", "price": 6.2, "point": 3.5},\ {"name": "Over", "description": "Logan Morris", "price": 7, "point": 3.5},\ ...\ ]\ }\ ]\ },\ ...\ \ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (head-to-head, handicap, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/afl-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/afl-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NCAA Baseball Odds API | The Odds API [#](https://the-odds-api.com/sports/ncaa-baseball-odds.html#ncaa-baseball-odds-api) NCAA Baseball Odds API =========================================================================================================== The Odds API covers NCAA baseball odds for live and upcoming games in a simple JSON API. Not a developer? Current NCAA baseball odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/ncaa-baseball-odds.html#features) Features ------------------------------------------------------------------------------- * NCAA baseball odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets such as player props are not currently offered by bookmakers for NCAA baseball. If this situation changes in future, these markets will be added to the API. * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NCAA baseball odds data is available on paid usage plans, available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/ncaa-baseball-odds.html#querying-ncaa-baseball-odds) Querying NCAA Baseball Odds --------------------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/ncaa-baseball-odds.html#query-featured-ncaa-baseball-markets) Query Featured NCAA Baseball Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current NCAA baseball odds for featured markets, the following parameters need to be provided: * **sport**   In this case `baseball_ncaa` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/baseball_ncaa/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NCAA baseball games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "e11a349c3291f7434e23c9af7457c35f",\ "sport_key": "baseball_ncaa",\ "sport_title": "NCAA Baseball",\ "commence_time": "2024-05-10T17:00:00Z",\ "home_team": "Utah Utes",\ "away_team": "Arizona Wildcats",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2024-05-10T16:49:22Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-05-10T16:49:22Z",\ "outcomes": [\ {"name": "Arizona Wildcats", "price": -175},\ {"name": "Utah Utes", "price": 135}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2024-05-10T16:49:22Z",\ "outcomes": [\ {"name": "Arizona Wildcats", "price": -125, "point": -1.5},\ {"name": "Utah Utes", "price": -105, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2024-05-10T16:49:22Z",\ "outcomes": [\ {"name": "Over", "price": -115, "point": 11.0},\ {"name": "Under", "price": -115, "point": 11.0}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/ncaa-baseball-odds.html#other-sports)\ Other Sports\ ---------------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/ncaa-baseball-odds.html#stay-updated)\ Stay Updated\ ---------------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # EPL Odds API | The Odds API [#](https://the-odds-api.com/sports/epl-odds.html#epl-odds-api) EPL Odds API ============================================================================= The Odds API covers EPL odds for live and upcoming matches in a simple JSON API. Not a developer? Current EPL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/epl-odds.html#features) Features --------------------------------------------------------------------- * EPL odds are covered for live and upcoming matches. * Featured markets, including 1X2, handicap, over/under are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html#au-bookmakers) . * Additional markets including player props, half time, double chance and more are covered for mainly US bookmakers, with coverage expanding to other bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * EPL scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical EPL odds data is available on paid usage plans. Historical odds for featured markets (1X2, handicap, over/under) are available from mid-2020. Historical odds for other markets are available from mid-2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/epl-odds.html#querying-epl-odds) Querying EPL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/epl-odds.html#query-featured-epl-markets) Query Featured EPL Markets Featured markets (1X2, handicap and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current EPL odds for featured markets, the following parameters need to be provided: * **sport**   In this case `soccer_epl` * **regions**   Regions of bookmakers to return, for example `eu` * **markets**   For example, `h2h` for 1X2, `spreads` for handicap, and `totals` for over/under * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/soccer_epl/odds?regions=eu&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming EPL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "c68b82f9cb2f42d00f21fcb79941dbe6",\ "sport_key": "soccer_epl",\ "sport_title": "EPL",\ "commence_time": "2025-08-30T11:30:00Z",\ "home_team": "Chelsea",\ "away_team": "Fulham",\ "bookmakers": [\ {\ "key": "onexbet",\ "title": "1xBet",\ "last_update": "2025-08-26T08:12:49Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-08-26T08:12:49Z",\ "outcomes": [\ {"name": "Chelsea", "price": 1.54},\ {"name": "Fulham", "price": 6.23},\ {"name": "Draw", "price": 4.62}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-08-26T08:12:49Z",\ "outcomes": [\ {"name": "Chelsea", "price": 2.46, "point": -1.5},\ {"name": "Fulham", "price": 1.61, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-08-26T08:12:49Z",\ "outcomes": [\ {"name": "Over", "price": 1.75, "point": 2.5},\ {"name": "Under", "price": 2.21, "point": 2.5}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/epl-odds.html#query-any-epl-market)\ Query Any EPL Market\ \ Any supported EPL markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current EPL odds for any market, including player props, half and quarter time markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `soccer_epl`\ * **eventId**   This example uses the id of Chelsea v Fulham (id c68b8...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `eu`\ * **markets**   For example `alternate_totals`, `double_chance`, `player_shots_on_target`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/soccer_epl/events/c68b82f9cb2f42d00f21fcb79941dbe6/odds/?apiKey=YOUR_API_KEY®ions=eu&markets=alternate_totals,double_chance,player_shots_on_target&oddsFormat=decimal\ \ \ **Example API Response**\ \ The response will contain the specified EPL game including odds from the specified bookmakers and markets.\ \ {\ "id": "c68b82f9cb2f42d00f21fcb79941dbe6",\ "sport_key": "soccer_epl",\ "sport_title": "EPL",\ "commence_time": "2025-08-30T11:30:00Z",\ "home_team": "Chelsea",\ "away_team": "Fulham",\ "bookmakers": [\ {\ "key": "onexbet",\ "title": "1xBet",\ "markets": [\ {\ "key": "double_chance",\ "last_update": "2025-08-26T08:11:31Z",\ "outcomes": [\ {"name": "Chelsea or Draw", "price": 1.15},\ {"name": "Fulham or Draw", "price": 2.62},\ {"name": "Chelsea or Fulham", "price": 1.23}\ ]\ },\ {\ "key": "alternate_totals",\ "last_update": "2025-08-26T08:11:46Z",\ "outcomes": [\ {"name": "Over", "price": 1.01, "point": 0.5},\ {"name": "Over", "price": 1.01, "point": 1},\ {"name": "Over", "price": 1.21, "point": 1.5},\ {"name": "Over", "price": 1.31, "point": 2},\ {"name": "Over", "price": 1.75, "point": 2.5},\ {"name": "Over", "price": 2.14, "point": 3},\ ...\ {"name": "Under", "price": 2.21, "point": 2.5},\ {"name": "Under", "price": 1.68, "point": 3},\ {"name": "Under", "price": 1.43, "point": 3.5},\ {"name": "Under", "price": 1.19, "point": 4},\ {"name": "Under", "price": 1.13, "point": 4.5},\ ...\ ]\ },\ {\ "key": "player_shots_on_target",\ "last_update": "2025-08-26T08:11:46Z",\ "outcomes": [\ {"name": "Over", "description": "Raul Jimenez", "price": 1.57, "point": 0.5},\ {"name": "Over", "description": "Raul Jimenez", "price": 3.75, "point": 1.5},\ {"name": "Over", "description": "Raul Jimenez", "price": 11, "point": 2.5},\ {"name": "Over", "description": "Kenny Tete", "price": 3, "point": 0.5},\ {"name": "Over", "description": "Kenny Tete", "price": 15, "point": 1.5},\ {"name": "Over", "description": "Reece James", "price": 2.62, "point": 0.5}\ ...\ ]\ }\ ]\ },\ ...\ \ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (1X2, handicap, over/under), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple matches.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/epl-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/epl-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NFL Preseason Odds API | The Odds API [#](https://the-odds-api.com/sports/nfl-preseason-odds.html#nfl-preseason-odds-api) NFL Preseason Odds API =========================================================================================================== The Odds API covers NFL preseason odds for live and upcoming games in a simple JSON API. Not a developer? Current NFL preseason odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. This page describes NFL **preseason** odds. Regular season NFL odds are [explained here](https://the-odds-api.com/sports/nfl-odds.html) [#](https://the-odds-api.com/sports/nfl-preseason-odds.html#features) Features ------------------------------------------------------------------------------- * NFL preseason odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets (such as player props) are not covered for NFL preseason since bookmakers usually have very limited coverage for the preseason. This may change in future. The API provides extensive coverage of [regular season NFL markets](https://the-odds-api.com/sports/nfl-odds.html) , including player props, game props, and more * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * NFL preseason scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NFL preseason odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/nfl-preseason-odds.html#querying-nfl-preseason-odds) Querying NFL Preseason Odds --------------------------------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/nfl-preseason-odds.html#query-featured-nfl-markets) Query Featured NFL Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current NFL preseason odds for featured markets, the following parameters need to be provided: * **sport**   In this case `americanfootball_nfl_preseason` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/americanfootball_nfl_preseason/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NFL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "a2c9f28280b60a277e237c7bb40b0d3c",\ "sport_key": "americanfootball_nfl_preseason",\ "sport_title": "NFL Preseason",\ "commence_time": "2025-08-15T23:01:00Z",\ "home_team": "Atlanta Falcons",\ "away_team": "Tennessee Titans",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2025-08-13T03:25:36Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-08-13T03:25:36Z",\ "outcomes": [\ {"name": "Atlanta Falcons", "price": 198},\ {"name": "Tennessee Titans", "price": -240}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-08-13T03:25:36Z",\ "outcomes": [\ {"name": "Atlanta Falcons", "price": -108, "point": 5.5},\ {"name": "Tennessee Titans", "price": -112, "point": -5.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-08-13T03:25:36Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 38.5},\ {"name": "Under", "price": -115, "point": 38.5}\ ]\ }\ ]\ },\ ...\ \ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/nfl-preseason-odds.html#other-sports)\ Other Sports\ ---------------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/nfl-preseason-odds.html#stay-updated)\ Stay Updated\ ---------------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # Tennis Odds API | The Odds API [#](https://the-odds-api.com/sports/tennis-odds.html#tennis-odds-api) Tennis Odds API ====================================================================================== The Odds API covers tennis odds for live and upcoming matches in a simple JSON API. Currently Grand Slams, ATP 1000 and WTA 1000 tournaments are covered, and new tournaments are periodically added. Not a developer? Current tennis odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/tennis-odds.html#features) Features ------------------------------------------------------------------------ * Tennis odds are covered for live and upcoming games. * Match winner odds are mainly covered at this time. Limited coverage is also available for game spreads and game totals (over/under) from selected bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical tennis odds data is available on paid usage plans as early as 2020 for Grand Slams. See the table below for details. More information on historical data can be found [on this page](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/tennis-odds.html#covered-tennis-tournaments) Covered Tennis Tournaments ------------------------------------------------------------------------------------------------------------ | League / Tournament | Sport Key
(use in the API) | Start of Historical Data | | --- | --- | --- | | ATP Australian Open | tennis\_atp\_aus\_open\_singles | 2021-02-06T11:45:00Z | | ATP Canadian Open | tennis\_atp\_canadian\_open | 2024-08-06T04:10:38Z | | ATP China Open | tennis\_atp\_china\_open | 2024-09-24T19:25:39Z | | ATP Cincinnati Open | tennis\_atp\_cincinnati\_open | 2024-08-12T01:50:38Z | | ATP Dubai Championships | tennis\_atp\_dubai | 2025-02-24T01:15:38Z | | ATP French Open | tennis\_atp\_french\_open | 2020-09-24T22:55:00Z | | ATP Indian Wells | tennis\_atp\_indian\_wells | 2025-03-04T22:20:40Z | | ATP Italian Open | tennis\_atp\_italian\_open | 2025-05-06T10:45:38Z | | ATP Madrid Open | tennis\_atp\_madrid\_open | 2025-04-22T05:55:38Z | | ATP Miami Open | tennis\_atp\_miami\_open | 2025-03-17T21:55:38Z | | ATP Monte-Carlo Masters | tennis\_atp\_monte\_carlo\_masters | 2025-04-06T09:30:38Z | | ATP Paris Masters | tennis\_atp\_paris\_masters | 2024-10-28T04:10:37Z | | ATP Qatar Open | tennis\_atp\_qatar\_open | 2025-02-16T10:00:38Z | | ATP Shanghai Masters | tennis\_atp\_shanghai\_masters | 2024-10-05T03:55:38Z | | ATP US Open | tennis\_atp\_us\_open | 2020-08-28T10:05:00Z | | ATP Wimbledon | tennis\_atp\_wimbledon | 2021-06-25T22:35:00Z | | WTA Australian Open | tennis\_wta\_aus\_open\_singles | 2021-02-06T11:45:00Z | | WTA Canadian Open | tennis\_wta\_canadian\_open | 2024-08-06T04:10:38Z | | WTA China Open | tennis\_wta\_china\_open | 2024-09-24T05:00:38Z | | WTA Cincinnati Open | tennis\_wta\_cincinnati\_open | 2024-08-12T01:50:38Z | | WTA Dubai Championships | tennis\_wta\_dubai | 2025-02-16T10:25:38Z | | WTA French Open | tennis\_wta\_french\_open | 2020-09-24T22:55:00Z | | WTA Indian Wells | tennis\_wta\_indian\_wells | 2025-03-04T23:30:39Z | | WTA Italian Open | tennis\_wta\_italian\_open | 2025-05-06T10:45:38Z | | WTA Madrid Open | tennis\_wta\_madrid\_open | 2025-04-22T05:55:38Z | | WTA Miami Open | tennis\_wta\_miami\_open | 2025-03-17T21:45:37Z | | WTA Qatar Open | tennis\_wta\_qatar\_open | 2025-02-10T05:10:37Z | | WTA US Open | tennis\_wta\_us\_open | 2020-08-28T10:05:00Z | | WTA Wimbledon | tennis\_wta\_wimbledon | 2021-06-25T22:45:00Z | | WTA Wuhan Open | tennis\_wta\_wuhan\_open | 2024-10-06T13:00:37Z | [#](https://the-odds-api.com/sports/tennis-odds.html#querying-tennis-odds) Querying Tennis Odds ------------------------------------------------------------------------------------------------ ### [#](https://the-odds-api.com/sports/tennis-odds.html#query-featured-tennis-markets) Query Featured Tennis Markets Featured markets, including match winner, game spreads and game totals odds can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current tennis odds for featured markets, the following parameters can be used: * **sport**   For example, `tennis_atp_french_open`. Data will only be returned if the tournament is in season * **regions**   Regions of bookmakers to return, for example `uk` * **markets**   For example, `h2h` for match winner. Game spreads (`spreads`) and games over/under (`totals`) are also available from some bookmakers. * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/tennis_atp_french_open/odds?regions=uk&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming tennis matches, including start times, competing players, and odds from bookmakers for the specified regions and markets. [{\ "id": "31a3d9a34b70c060f165cc2051676443",\ "sport_key": "tennis_atp_french_open",\ "sport_title": "ATP French Open",\ "commence_time": "2025-05-31T09:00:00Z",\ "home_team": "Tallon Griekspoor",\ "away_team": "Ethan Quinn",\ "bookmakers": [\ {\ "key": "grosvenor",\ "title": "Grosvenor",\ "last_update": "2025-05-31T03:22:14Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-05-31T03:22:14Z",\ "outcomes": [\ {"name": "Ethan Quinn", "price": 4.6},\ {"name": "Tallon Griekspoor", "price": 1.21}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-05-31T03:22:14Z",\ "outcomes": [\ {"name": "Ethan Quinn", "price": 1.83, "point": 5.5},\ {"name": "Tallon Griekspoor", "price": 1.94, "point": -5.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-05-31T03:22:14Z",\ "outcomes": [\ {"name": "Over", "price": 1.93, "point": 38.5},\ {"name": "Under", "price": 1.85, "point": 38.5}\ ]\ }\ ]\ },\ {\ "key": "betway",\ "title": "Betway",\ "last_update": "2025-05-31T03:10:15Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-05-31T03:10:15Z",\ "outcomes": [\ {"name": "Ethan Quinn", "price": 5.25},\ {"name": "Tallon Griekspoor", "price": 1.15}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credit\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/tennis-odds.html#other-sports)\ Other Sports\ --------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/tennis-odds.html#stay-updated)\ Stay Updated\ --------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # Odds Widget Docs V1 | The Odds API [#](https://the-odds-api.com/widget/v1/#page-frontmatter-title) Odds Widget Docs V1 ==================================================================================== [#](https://the-odds-api.com/widget/v1/#overview) Overview ----------------------------------------------------------- The odds widget lets you add recent odds to your website, along with your own bookmaker affiliate links and without the need for code. Odds are available for several [sports](https://the-odds-api.com/sports-odds-data/sports-apis.html) and [bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . ### [#](https://the-odds-api.com/widget/v1/#getting-started) Getting started 1. Sign up for a free subscription to get an access key. Widget subscriptions can be found on the [accounts page](https://the-odds-api.com/account/?path=widget-subscriptions) . 2. On your subscription, add your affiliate links for the bookmakers of interest ![Widget Affiliate Links](https://the-odds-api.com/assets/img/widget_affiliate_links.jpg) 3. Using the [odds widget builder](https://the-odds-api.com/widget/v1/builder.html) , construct the odds widget HTML tag by selecting the sport, bookmaker and markets of interest, as well as other parameters. Example: 4. Copy and paste the widget HTML tag into your website. Odds will automatically come through. When a user clicks the link in the widget, it will use your affiliate link for the specified bookmaker. [#](https://the-odds-api.com/widget/v1/#the-odds-widget-html-tag) The Odds Widget HTML Tag ------------------------------------------------------------------------------------------- The [odds widget builder](https://the-odds-api.com/widget/v1/builder.html) is the easiest way to construct the odds widget HTML tag. Alternatively you can use these docs to manually construct the HTML tag or to learn more about the parameters. The odds widget displays odds for live and upcoming games (events) for a given sport and bookmaker. An HTML iframe tag uses the following url format in its `src` attribute: https://widget.the-odds-api.com/v1/sports/{sportKey}/events/?accessKey={accessKey}&bookmakerKeys={bookmakerKeys}&oddsFormat={oddsFormat}&markets={markets}&marketNames={marketNames} ### [#](https://the-odds-api.com/widget/v1/#path-parameters) Path Parameters * **sportKey**   Specifies the league or competition for which games are returned. A list of available sport keys can be [found here](https://the-odds-api.com/sports-odds-data/sports-apis.html) . Tournaments with futures (outright) odds are not supported in the widget at this time. ### [#](https://the-odds-api.com/widget/v1/#query-parameters) Query Parameters * **accessKey**   An access key that comes with a [widget subscription](https://the-odds-api.com/account/?path=widget-subscriptions) . The widget access key starts with `wk_` * **bookmakerKeys**   The bookmaker key whose odds and affiliate link are to be displayed in the widget. Currently this parameter only accepts one bookmaker key. A list of valid bookmaker keys can be [found here](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . Based on user feedback, we may allow multiple bookmakers in future. * **oddsFormat**   Optional - Determines the format of odds in the response. Valid values are `decimal` and `american`. Defaults to `decimal`. When set to `american`, small discrepancies might exist for some bookmakers due to rounding errors. * **markets**   Optional - A comma-separated list of odds markets to be returned. Defaults to `h2h,spreads,totals`. Valid markets are `h2h` (head-to-head or moneyline), `spreads` (points handicaps), `totals` (over/under). For more info, see [descriptions of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . Outrights (futures) are not yet available in the widget. * **marketNames**   Optional - this allows you to rename markets to be more specific to the sport or your region. This parameter is a string of comma separated `market:label` pairs. For example, for MLB, you may wish to rename head-to-head to "Moneyline", and rename spreads to "Run Line". This can be done by setting the marketNames parameter as follows `marketNames=h2h:Moneyline,spreads:Run%20Line` ### [#](https://the-odds-api.com/widget/v1/#examples) Examples #### [#](https://the-odds-api.com/widget/v1/#url) URL https://widget.the-odds-api.com/v1/sports/americanfootball_nfl/events/?accessKey=wk_abcdef01234567890123456789012345&bookmakerKeys=draftkings&oddsFormat=american&markets=h2h,spreads,totals&marketNames=h2h:Moneyline,spreads:Spread,totals:Total #### [#](https://the-odds-api.com/widget/v1/#html-tag) HTML Tag #### [#](https://the-odds-api.com/widget/v1/#browser-concept) Browser Concept ![Odds Widget HTML Tag](https://the-odds-api.com/assets/img/widget_browser.png) [#](https://the-odds-api.com/widget/v1/#other-widget-scenarios) Other Widget Scenarios --------------------------------------------------------------------------------------- The following lists screenshots of messages that the widget will display during selected scenarios. #### [#](https://the-odds-api.com/widget/v1/#access-key-out-of-usage-quota) Access key out of usage quota ![Odds Widget HTML Tag](https://the-odds-api.com/assets/img/widget_usage_quota.jpg) #### [#](https://the-odds-api.com/widget/v1/#games-not-listing) Games not listing ![Odds Widget HTML Tag](https://the-odds-api.com/assets/img/widget_missing_games.jpg) #### [#](https://the-odds-api.com/widget/v1/#games-with-missing-markets) Games with missing markets ![Odds Widget HTML Tag](https://the-odds-api.com/assets/img/widget_missing_markets.jpg) [#](https://the-odds-api.com/widget/v1/#usage-quota-costs) Usage Quota Costs ----------------------------------------------------------------------------- Each time a widget HTML tag is loaded (typically a website visit), it will cost 1 from the usage quota. Keeping track of quota usage The usage quota can be tracked on the [accounts page](https://the-odds-api.com/account/?path=widget-subscriptions) . [#](https://the-odds-api.com/widget/v1/#more-info) More Info ------------------------------------------------------------- * The list of games returned in the /odds endpoint mirrors games that are listed by major bookmakers. This usually includes games for the current round * Games may temporarily become unavailable after a round, before bookmakers begin listing the next round of games * Games may be unavailable if the sport is not in season. For popular sports, bookmakers may begin listing round 1 games a few months in advance Stay up to date on new sports, bookmakers and features by [following us on X.com (opens new window)](https://twitter.com/The_Odds_API) --- # MLB Odds API | The Odds API [#](https://the-odds-api.com/sports/mlb-odds.html#mlb-odds-api) MLB Odds API ============================================================================= The Odds API covers MLB odds for live and upcoming games in a simple JSON API. Not a developer? Current MLB odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/mlb-odds.html#features) Features --------------------------------------------------------------------- * MLB odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, innings markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * MLB scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical MLB odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/mlb-odds.html#querying-mlb-odds) Querying MLB Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/mlb-odds.html#query-featured-mlb-markets) Query Featured MLB Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current MLB odds for featured markets, the following parameters need to be provided: * **sport**   In this case `baseball_mlb` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/baseball_mlb/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming MLB games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "d537f87ae371eead1102a5016d6c2659",\ "sport_key": "baseball_mlb",\ "sport_title": "MLB",\ "commence_time": "2024-08-20T22:41:00Z",\ "home_team": "Miami Marlins",\ "away_team": "Arizona Diamondbacks",\ "bookmakers": [\ {\ "key": "betmgm",\ "title": "BetMGM",\ "last_update": "2024-08-20T17:54:21Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-08-20T17:54:21Z",\ "outcomes": [\ {"name": "Arizona Diamondbacks", "price": -150},\ {"name": "Miami Marlins", "price": 125}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2024-08-20T17:54:21Z",\ "outcomes": [\ {"name": "Arizona Diamondbacks", "price": 105, "point": -1.5},\ {"name": "Miami Marlins", "price": -130, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2024-08-20T17:54:21Z",\ "outcomes": [\ {"name": "Over", "price": -115, "point": 7.5},\ {"name": "Under", "price": -105, "point": 7.5}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/mlb-odds.html#query-any-mlb-markets)\ Query Any MLB Markets\ \ Any supported MLB markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current MLB odds for any market, including player props, innings markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `baseball_mlb`\ * **eventId**   This example uses the id of Diamondbacks @ Marlins (id d537...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_1st_5_innings` (1st 5 innings moneyline), `batter_home_runs`, `pitcher_strikeouts`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/baseball_mlb/events/d537f87ae371eead1102a5016d6c2659/odds?regions=us&markets=h2h_1st_5_innings,batter_home_runs,pitcher_strikeouts&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified MLB game including odds from the specified bookmakers and markets.\ \ {\ "id": "d537f87ae371eead1102a5016d6c2659",\ "sport_key": "baseball_mlb",\ "sport_title": "MLB",\ "commence_time": "2024-08-20T22:41:00Z",\ "home_team": "Miami Marlins",\ "away_team": "Arizona Diamondbacks",\ "bookmakers": [{\ "key": "betmgm",\ "title": "BetMGM",\ "last_update": "2024-08-20T17:54:21Z",\ "markets": [\ {\ "key": "batter_home_runs",\ "last_update": "2024-08-20T17:54:42Z",\ "outcomes": [\ {"name": "Over", "description": "Eugenio Suarez", "price": 525, "point": 0.5},\ {"name": "Under", "description": "Eugenio Suarez", "price": -750, "point": 0.5},\ {"name": "Over", "description": "Derek Hill", "price": 1000, "point": 0.5},\ {"name": "Under", "description": "Derek Hill", "price": -2000, "point": 0.5},\ ...\ ]\ },\ {\ "key": "h2h_1st_5_innings",\ "last_update": "2024-08-20T17:54:42Z",\ "outcomes": [\ {"name": "Arizona Diamondbacks", "price": -145},\ {"name": "Miami Marlins", "price": 115}\ ]\ },\ {\ "key": "pitcher_strikeouts",\ "last_update": "2024-08-20T17:54:42Z",\ "outcomes": [\ {"name": "Over", "description": "Eduardo Rodriguez", "price": -125, "point": 4.5},\ {"name": "Under", "description": "Eduardo Rodriguez", "price": -105, "point": 4.5},\ {"name": "Over", "description": "Edward Cabrera", "price": -150, "point": 4.5},\ {"name": "Under", "description": "Edward Cabrera", "price": 115, "point": 4.5\ }\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/mlb-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/mlb-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # UFL Odds API | The Odds API [#](https://the-odds-api.com/sports/ufl-odds.html#ufl-odds-api) UFL Odds API ============================================================================= The Odds API covers UFL (United Football League) odds for live and upcoming games in a simple JSON API. Not a developer? Current UFL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/ufl-odds.html#features) Features --------------------------------------------------------------------- * UFL odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * UFL scores are covered, with final scores available for games completed up to 3 days ago. * Historical UFL odds data is available from February 2023 on paid usage plans. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * UFL was called XFL before 2024. To access 2023 historical data, use the sport key `americanfootball_xfl` * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/ufl-odds.html#querying-ufl-odds) Querying UFL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/ufl-odds.html#query-featured-ufl-markets) Query Featured UFL Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current UFL odds for featured markets, the following parameters can be used: * **sport**   In this case `americanfootball_ufl` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/americanfootball_ufl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming UFL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "8ef38e6ed505d692893d7364f73016c2",\ "sport_key": "americanfootball_ufl",\ "sport_title": "UFL",\ "commence_time": "2025-05-31T00:00:00Z",\ "home_team": "DC Defenders",\ "away_team": "St. Louis Battlehawks",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2025-05-30T14:56:42Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-05-30T14:56:42Z",\ "outcomes": [\ {"name": "DC Defenders", "price": 124},\ {"name": "St. Louis Battlehawks", "price": -148}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-05-30T14:56:42Z",\ "outcomes": [\ {"name": "DC Defenders", "price": -108, "point": 2.5},\ {"name": "St. Louis Battlehawks", "price": -112, "point": -2.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-05-30T14:56:42Z",\ "outcomes": [\ {"name": "Over", "price": -115, "point": 42.5},\ {"name": "Under", "price": -105, "point": 42.5}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/ufl-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/ufl-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # PLL Odds API | The Odds API [#](https://the-odds-api.com/sports/pll-odds.html#pll-odds-api) PLL Odds API ============================================================================= The Odds API covers PLL (Premier Lacrosse League) odds for live and upcoming games in a simple JSON API. Not a developer? Current PLL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/pll-odds.html#features) Features --------------------------------------------------------------------- * PLL odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical PLL odds data is available from May 2024 on paid usage plans. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/pll-odds.html#querying-pll-odds) Querying PLL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/pll-odds.html#query-featured-pll-markets) Query Featured PLL Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current PLL odds for featured markets, the following parameters need to be provided: * **sport**   In this case `lacrosse_pll` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/lacrosse_pll/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming PLL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "e780b78f47cca2f7780cc7bef1000e17",\ "sport_key": "lacrosse_pll",\ "sport_title": "PLL",\ "commence_time": "2024-06-01T17:00:00Z",\ "home_team": "Philadelphia Waterdogs",\ "away_team": "Utah Archers",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2024-06-01T15:09:45Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-06-01T15:09:45Z",\ "outcomes": [\ {"name": "Philadelphia Waterdogs", "price": -115},\ {"name": "Utah Archers", "price": -115}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2024-06-01T15:09:45Z",\ "outcomes": [\ {"name": "Philadelphia Waterdogs", "price": 124, "point": -1.5},\ {"name": "Utah Archers", "price": -160, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2024-06-01T15:09:45Z",\ "outcomes": [\ {"name": "Over", "price": -115, "point": 26.0},\ {"name": "Under", "price": -115, "point": 26.0}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/pll-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/pll-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # WNCAAB Odds API | The Odds API [#](https://the-odds-api.com/sports/wncaab-odds.html#wncaab-odds-api) WNCAAB Odds API ====================================================================================== The Odds API covers Women's College Basketball (WNCAAB) odds for live and upcoming games in a simple JSON API. Not a developer? Current WNCAAB odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/wncaab-odds.html#features) Features ------------------------------------------------------------------------ * WNCAAB odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets such as player props are not currently offered by bookmakers for WNCAAB. If this situation changes in future, these markets will be added to the API. * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * Current odds data are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical WNCAAB odds data is available on paid usage plans. Historical odds for WNCAAB featured markets (moneyline, spreads, totals) are available from Nov 12, 2024. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. [#](https://the-odds-api.com/sports/wncaab-odds.html#querying-wncaab-odds) Querying WNCAAB Odds ------------------------------------------------------------------------------------------------ ### [#](https://the-odds-api.com/sports/wncaab-odds.html#query-featured-wncaab-markets) Query Featured WNCAAB Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . **Parameters** To query current WNCAAB odds for featured markets, the following parameters need to be provided: * **sport**   In this case `basketball_wncaab` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/basketball_wncaab/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming WNCAAB games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "c77b0099dd25b7fac3ff086aeb3f0420",\ "sport_key": "basketball_wncaab",\ "sport_title": "WNCAAB",\ "commence_time": "2025-02-02T01:30:00Z",\ "home_team": "Arizona St Sun Devils",\ "away_team": "BYU Cougars",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2025-02-02T00:53:13Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-02-02T00:53:13Z",\ "outcomes": [\ {"name": "Arizona St Sun Devils", "price": 110},\ {"name": "BYU Cougars", "price": -134}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-02-02T00:53:13Z",\ "outcomes": [\ {"name": "Arizona St Sun Devils", "price": -104, "point": 1.5},\ {"name": "BYU Cougars", "price": -118, "point": -1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-02-02T00:53:13Z",\ "outcomes": [\ {"name": "Over", "price": -110, "point": 144.5},\ {"name": "Under", "price": -110, "point": 144.5}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ [#](https://the-odds-api.com/sports/wncaab-odds.html#other-sports)\ Other Sports\ --------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/wncaab-odds.html#stay-updated)\ Stay Updated\ --------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NBA Odds API | The Odds API [#](https://the-odds-api.com/sports/nba-odds.html#nba-odds-api) NBA Odds API ============================================================================= The Odds API covers NBA odds for live and upcoming games in a simple JSON API. Not a developer? Current NBA odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/nba-odds.html#features) Features --------------------------------------------------------------------- * NBA odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, quarter and half time markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * NBA scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NBA odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/nba-odds.html#querying-nba-odds) Querying NBA Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/nba-odds.html#query-featured-nba-markets) Query Featured NBA Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current NBA odds for featured markets, the following parameters need to be provided: * **sport**   In this case `basketball_nba` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/basketball_nba/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NBA games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "2147587132aa05de18df6c158da786ec",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2025-02-12T03:00:00Z",\ "home_team": "Phoenix Suns",\ "away_team": "Memphis Grizzlies",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2025-02-12T00:59:48Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-02-12T00:59:48Z",\ "outcomes": [\ {"name": "Memphis Grizzlies", "price": -192},\ {"name": "Phoenix Suns", "price": 160}\ ]\ }, {\ "key": "spreads",\ "last_update": "2025-02-12T00:59:48Z",\ "outcomes": [\ {"name": "Memphis Grizzlies", "price": -110, "point": -4.5},\ {"name": "Phoenix Suns", "price": -110, "point": 4.5}\ ]\ }, {\ "key": "totals",\ "last_update": "2025-02-12T00:59:48Z",\ "outcomes": [\ {"name": "Over", "price": -108, "point": 246.0},\ {"name": "Under", "price": -112,"point": 246.0}\ ]\ }]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/nba-odds.html#query-any-nba-markets)\ Query Any NBA Markets\ \ Any supported NBA markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current NBA odds for any market, including player props, half and quarter time markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `basketball_nba`\ * **eventId**   This example uses the id of Grizzlies @ Suns (id 21475...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_h1` (1st half moneyline), `player_points`, `player_rebounds`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/basketball_nba/events/2147587132aa05de18df6c158da786ec/odds?regions=us&markets=h2h_h1,player_points,player_rebounds&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified NBA game including odds from the specified bookmakers and markets.\ \ {\ "id": "2147587132aa05de18df6c158da786ec",\ "sport_key": "basketball_nba",\ "sport_title": "NBA",\ "commence_time": "2025-02-12T03:00:00Z",\ "home_team": "Phoenix Suns",\ "away_team": "Memphis Grizzlies",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "markets": [\ {\ "key": "h2h_h1",\ "last_update": "2025-02-12T01:06:51Z",\ "outcomes": [\ {"name": "Memphis Grizzlies", "price": -170},\ {"name": "Phoenix Suns", "price": 142}\ ]\ }, {\ "key": "player_points",\ "last_update": "2025-02-12T01:06:51Z",\ "outcomes": [\ {"name": "Over", "description": "Devin Booker", "price": -110, "point": 28.5},\ {"name": "Under", "description": "Devin Booker", "price": -120, "point": 28.5},\ {"name": "Over", "description": "Kevin Durant", "price": -105, "point": 27.5},\ {"name": "Under", "description": "Kevin Durant", "price": -125, "point": 27.5},\ ...\ },\ {\ "key": "player_rebounds",\ "last_update": "2025-02-12T01:06:51Z",\ "outcomes": [\ {"name": "Over", "description": "Nick Richards", "price": 100, "point": 8.5},\ {"name": "Under", "description": "Nick Richards", "price": -130, "point": 8.5},\ {"name": "Over", "description": "Zach Edey", "price": -105, "point": 7.5},\ {"name": "Under", "description": "Zach Edey", "price": -125, "point": 7.5},\ ...\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/nba-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/nba-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # Odds Widget | The Odds API Sports odds widget for websites Get Widget → * Monetize using bookmaker affiliate links * Easy setup with a simple HTML tag * Choose from loads of sports & bookmakers [#](https://the-odds-api.com/widget/#usage-plans) Usage Plans -------------------------------------------------------------- Starter FREE   500 visits\* per month All sports All bookmakers All featured betting markets Small $20 per month, USD 5,000 visits\* per month All sports All bookmakers All featured betting markets Medium $100 per month, USD 100,000 visits\* per month All sports All bookmakers All featured betting markets \*Each time a widget HTML tag is loaded (typically on a website visit), it will count as 1 visit from the usage quota. Create Account **Need a larger plan?** Contact us at [team@the-odds-api.com](mailto:team@the-odds-api.com) [#](https://the-odds-api.com/widget/#odds-widget-html-tag) Odds Widget HTML Tag -------------------------------------------------------------------------------- The widget displays odds for live and upcoming games for a selected sport and bookmaker. Simply copy the widget HTML tag into your website's HTML code. Odds will only display if the sport is in-season and bookmakers are listing games. For a detailed description on each of the fields below, see [the docs](https://the-odds-api.com/widget/v1/) . ### HTML Tag Builder Access Key Get a free access key by [creating an account](https://the-odds-api.com/account/?path=widget-subscriptions) You can also set affiliate links for the bookmakers that you wish to display Sport Show live and upcoming games for this sport American Football: CFL American Football: NCAAF American Football: NCAAF Championship Winner American Football: NFL American Football: NFL Preseason American Football: NFL Super Bowl Winner American Football: UFL Aussie Rules: AFL Baseball: MLB Baseball: MLB Preseason Baseball: MLB World Series Winner Baseball: Minor League Baseball Baseball: NPB Baseball: KBO League Baseball: NCAA Baseball Basketball: Basketball Euroleague Basketball: NBA Basketball: NBA Preseason Basketball: NBA Summer League Basketball: NBA Championship Winner Basketball: WNBA Basketball: NCAAB Basketball: WNCAAB Basketball: NCAAB Championship Winner Basketball: NBL (Australia) Boxing: Boxing Cricket: Asia Cup Cricket: Big Bash Cricket: Caribbean Premier League Cricket: ICC Champions Trophy Cricket: ICC World Cup Cricket: ICC Women's World Cup Cricket: International Twenty20 Cricket: IPL Cricket: One Day Internationals Cricket: Pakistan Super League Cricket: T20 Blast Cricket: Test Matches Cricket: The Hundred Golf: Masters Tournament Winner Golf: PGA Championship Winner Golf: The Open Winner Golf: US Open Winner Handball: Handball-Bundesliga Ice Hockey: NHL Ice Hockey: NHL Preseason Ice Hockey: AHL Ice Hockey: NHL Championship Winner Ice Hockey: Finnish Liiga Ice Hockey: Finnish Mestis Ice Hockey: SHL Ice Hockey: HockeyAllsvenskan Lacrosse: Premier Lacrosse League Lacrosse: NCAA Lacrosse Mixed Martial Arts: MMA Politics: US Presidential Elections Winner Rugby League: NRL Rugby League: NRL State of Origin Rugby Union: Six Nations Soccer: Africa Cup of Nations Soccer: Primera División - Argentina Soccer: A-League Soccer: Austrian Football Bundesliga Soccer: Belgium First Div Soccer: Brazil Série A Soccer: Brazil Série B Soccer: Primera División - Chile Soccer: Super League - China Soccer: Denmark Superliga Soccer: Championship Soccer: EFL Cup Soccer: League 1 Soccer: League 2 Soccer: EPL Soccer: FA Cup Soccer: FIFA World Cup Soccer: FIFA World Cup Qualifiers - Europe Soccer: FIFA World Cup Qualifiers - South America Soccer: FIFA Women's World Cup Soccer: FIFA World Cup Winner Soccer: FIFA Club World Cup Soccer: Veikkausliiga - Finland Soccer: Ligue 1 - France Soccer: Ligue 2 - France Soccer: Bundesliga - Germany Soccer: Bundesliga 2 - Germany Soccer: 3. Liga - Germany Soccer: Super League - Greece Soccer: Serie A - Italy Soccer: Serie B - Italy Soccer: J League Soccer: K League 1 Soccer: League of Ireland Soccer: Liga MX Soccer: Dutch Eredivisie Soccer: Eliteserien - Norway Soccer: Ekstraklasa - Poland Soccer: Primeira Liga - Portugal Soccer: Premier League - Russia Soccer: La Liga - Spain Soccer: La Liga 2 - Spain Soccer: Premiership - Scotland Soccer: Allsvenskan - Sweden Soccer: Superettan - Sweden Soccer: Swiss Superleague Soccer: Turkey Super League Soccer: UEFA Europa Conference League Soccer: UEFA Champions League Soccer: UEFA Champions League Qualification Soccer: UEFA Women's Champions League Soccer: UEFA Europa League Soccer: UEFA Euro 2024 Soccer: UEFA Euro Qualification Soccer: UEFA Nations League Soccer: CONCACAF Gold Cup Soccer: CONCACAF Leagues Cup Soccer: Copa América Soccer: Copa Libertadores Soccer: Copa Sudamericana Soccer: MLS Tennis: ATP Australian Open Tennis: ATP Canadian Open Tennis: ATP China Open Tennis: ATP Cincinnati Open Tennis: ATP Dubai Championships Tennis: ATP French Open Tennis: ATP Indian Wells Tennis: ATP Italian Open Tennis: ATP Madrid Open Tennis: ATP Miami Open Tennis: ATP Monte-Carlo Masters Tennis: ATP Paris Masters Tennis: ATP Qatar Open Tennis: ATP Shanghai Masters Tennis: ATP US Open Tennis: ATP Wimbledon Tennis: WTA Australian Open Tennis: WTA Canadian Open Tennis: WTA China Open Tennis: WTA Cincinnati Open Tennis: WTA Dubai Championships Tennis: WTA French Open Tennis: WTA Indian Wells Tennis: WTA Italian Open Tennis: WTA Madrid Open Tennis: WTA Miami Open Tennis: WTA Qatar Open Tennis: WTA US Open Tennis: WTA Wimbledon Tennis: WTA Wuhan Open Bookmaker The bookmaker whose odds are to be displayed, along with your affiliate link BetOnline.ag BetMGM BetRivers BetUS Bovada Caesars DraftKings Fanatics FanDuel LowVig.ag MyBookie.ag Bally Bet BetAnything betPARX ESPN BET Fliff Hard Rock Bet ReBet 888sport Betfair Exchange Betfair Sportsbook Bet Victor Betway BoyleSports Casumo Coral Grosvenor Ladbrokes LeoVegas LiveScore Bet Matchbook Paddy Power Sky Bet Smarkets Unibet Virgin Bet William Hill (UK) 1xBet 888sport Betclic (FR) BetAnySports Betfair Exchange BetOnline.ag Betsson Codere (IT) Bet Victor Coolbet Everygame GTbets LeoVegas (SE) Marathon Bet Matchbook MyBookie.ag NordicBet Parions Sport (FR) Pinnacle PMU (FR) Suprabets Tipico (DE) Unibet (FR) Unibet (IT) Unibet (NL) Unibet (SE) William Hill Winamax (DE) Winamax (FR) Betfair Exchange Betr Bet Right Bet365 AU BoomBet Dabble AU Ladbrokes Neds PlayUp PointsBet (AU) SportsBet TAB TABtouch Unibet Odds Format American Decimal Markets Click and drag, or shift + click to select multiple h2h (head-to-head, moneyline, 1x2...) spreads (handicap) totals (over/under) Custom Market Names Override the names of the markets to suit the sport or the region of your users h2h: spreads: totals: ### Preview HTML Tag Copy and paste into your website's HTML code `` #### [#](https://the-odds-api.com/widget/#add-affiliate-links-to-the-widget) Add affiliate links to the widget After you've added the widget tag to your website, bookmaker affiliate links can be added to the widget via [your account](https://the-odds-api.com/account/?path=widget-subscriptions) . For more info, see [monetizing your website](https://the-odds-api.com/widget/how-to-add-odds-widget.html#monetize-your-website-with-bookmaker-affiliate-links) . [#](https://the-odds-api.com/widget/#more-info) More info ---------------------------------------------------------- * [How to add the odds widget to websites](https://the-odds-api.com/widget/how-to-add-odds-widget.html#bring-sports-odds-into-your-website) , including Wix and Wordpress.org * [List of available sports](https://the-odds-api.com/sports-odds-data/sports-apis.html) * [List of available bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) [#](https://the-odds-api.com/widget/#faqs) FAQs ------------------------------------------------ Q When am I billed? For paid plans, billing happens straight away. Payment then happens automatically each month thereafter, on the same day of the month that the subscription started. For example if the first payment happens on the 1st of the month, you will be charged on the 1st for subsequent months. Q What is a visit? Each time a widget HTML tag is loaded (typically on a website visit), it will count as 1 visit from the usage quota. Q How can I cancel? A subscription can be cancelled from your account. * Log into [your account](https://the-odds-api.com/account/?path=widget-subscriptions) * Click "Manage Subscription" on the relevant subscription * Click "Cancel plan" Q How can I update my credit card details? Billing details can be managed in your account. * Log into [your account](https://the-odds-api.com/account/?path=widget-subscriptions) * Click "Manage Subscription" on the relevant subscription * Click "Add payment method" [More FAQs →](https://the-odds-api.com/manage/faqs-widget.html) [#](https://the-odds-api.com/widget/#stay-updated) Stay Updated ---------------------------------------------------------------- Follow us on [X.com](https://twitter.com/The_Odds_API) or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social) to stay updated on new sports, bookmakers and features --- # NHL Odds API | The Odds API [#](https://the-odds-api.com/sports/nhl-odds.html#nhl-odds-api) NHL Odds API ============================================================================= The Odds API covers NHL odds for live and upcoming games in a simple JSON API. Not a developer? Current NHL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/nhl-odds.html#features) Features --------------------------------------------------------------------- * NHL odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, period markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * NHL scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NHL odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/nhl-odds.html#querying-nhl-odds) Querying NHL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/nhl-odds.html#query-featured-nhl-markets) Query Featured NHL Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current NHL odds for featured markets, the following parameters need to be provided: * **sport**   In this case `icehockey_nhl` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options. **Example API Request** https://api.the-odds-api.com/v4/sports/icehockey_nhl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NHL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "9e772482d5eda16bbc03e0e7b249ee1c",\ "sport_key": "icehockey_nhl",\ "sport_title": "NHL",\ "commence_time": "2025-01-20T18:00:00Z",\ "home_team": "Boston Bruins",\ "away_team": "San Jose Sharks",\ "bookmakers": [\ {\ "key": "betrivers",\ "title": "BetRivers",\ "last_update": "2025-01-20T12:04:30Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-01-20T12:04:30Z",\ "outcomes": [\ {"name": "Boston Bruins", "price": -250},\ {"name": "San Jose Sharks", "price": 200}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-01-20T12:04:30Z",\ "outcomes": [\ {"name": "Boston Bruins", "price": 102, "point": -1.5},\ {"name": "San Jose Sharks", "price": -124, "point": 1.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-01-20T12:04:30Z",\ "outcomes": [\ {"name": "Over", "price": 104, "point": 6.0},\ {"name": "Under", "price": -125, "point": 6.0}\ ]\ }\ ]},\ \ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ For ice hockey, the `h2h` market currently displays the market that is featured on each bookmaker's website (the market shown on a bookmaker's main events page). EU bookmakers typically feature regular time odds (includes draw), whilst US bookmakers typically feature the overtime odds (excludes draw).\ \ ### [#](https://the-odds-api.com/sports/nhl-odds.html#query-any-nhl-markets)\ Query Any NHL Markets\ \ Any supported NHL markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current NHL odds for any market, including player props, period markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `icehockey_nhl`\ * **eventId**   This example uses the id of Sharks @ Bruins (id 9e772...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_p1` (1st period moneyline), `player_shots_on_goal`, `player_goal_scorer_anytime`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/icehockey_nhl/events/9e772482d5eda16bbc03e0e7b249ee1c/odds?regions=us&markets=h2h_p1,player_shots_on_goal,player_goal_scorer_anytime&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified NHL game including odds from the specified bookmakers and markets.\ \ {\ "id": "9e772482d5eda16bbc03e0e7b249ee1c",\ "sport_key": "icehockey_nhl",\ "sport_title": "NHL",\ "commence_time": "2025-01-20T18:00:00Z",\ "home_team": "Boston Bruins",\ "away_team": "San Jose Sharks",\ "bookmakers": [\ {\ "key": "betrivers",\ "title": "BetRivers",\ "last_update": "2025-01-20T12:04:30Z",\ "markets": [\ {\ "key": "h2h_p1",\ "last_update": "2025-01-20T12:04:59Z",\ "outcomes": [\ {"name": "Boston Bruins", "price": -225},\ {"name": "San Jose Sharks", "price": 170}\ ]\ },\ {\ "key": "player_goal_scorer_anytime",\ "last_update": "2025-01-20T12:04:59Z",\ "outcomes": [\ {"name": "Yes", "description": "Luke Kunin", "price": 575},\ {"name": "Yes", "description": "Elias Lindholm", "price": 205},\ {"name": "Yes", "description": "Macklin Celebrini", "price": 220},\ ...\ ]\ },\ {\ "key": "player_shots_on_goal",\ "last_update": "2025-01-20T12:04:59Z",\ "outcomes": [\ {"name": "Over", "description": "Pavel Zacha", "price": -165, "point": 1.5},\ {"name": "Under", "description": "Pavel Zacha", "price": 125, "point": 1.5},\ {"name": "Over", "description": "Elias Lindholm", "price": -177, "point": 1.5},\ {"name": "Under", "description": "Elias Lindholm", "price": 135, "point": 1.5},\ ...\ ]\ }\ ],\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/nhl-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/nhl-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NCAA Basketball Odds API | The Odds API [#](https://the-odds-api.com/sports/ncaab-odds.html#ncaa-basketball-odds-api) NCAA Basketball Odds API ======================================================================================================= The Odds API covers NCAAB odds for live and upcoming games in a simple JSON API. Not a developer? Current NCAAB odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/ncaab-odds.html#features) Features ----------------------------------------------------------------------- * NCAAB odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, quarter and half time markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * NCAAB scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NCAAB odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/ncaab-odds.html#querying-ncaab-odds) Querying NCAAB Odds --------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/ncaab-odds.html#query-featured-ncaab-markets) Query Featured NCAAB Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current NCAAB odds for featured markets, the following parameters need to be provided: * **sport**   In this case `basketball_ncaab` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/basketball_ncaab/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NCAAB games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "9d4a4c158fb7ee8ac579ea4d16eb4633",\ "sport_key": "basketball_ncaab",\ "sport_title": "NCAAB",\ "commence_time": "2025-02-15T00:00:00Z",\ "home_team": "Loyola (Chi) Ramblers",\ "away_team": "Saint Louis Billikens",\ "bookmakers": [\ {\ "key": "betonlineag",\ "title": "BetOnline.ag",\ "last_update": "2025-02-14T23:16:03Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2025-02-14T23:16:03Z",\ "outcomes": [\ {"name": "Loyola (Chi) Ramblers", "price": -145},\ {"name": "Saint Louis Billikens", "price": 125}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2025-02-14T23:16:03Z",\ "outcomes": [\ {"name": "Loyola (Chi) Ramblers", "price": -112, "point": -2.0},\ {"name": "Saint Louis Billikens", "price": -108, "point": 2.0}\ ]\ },\ {\ "key": "totals",\ "last_update": "2025-02-14T23:16:03Z",\ "outcomes": [\ {"name": "Over", "price": -105, "point": 140.0},\ {"name": "Under", "price": -115, "point": 140.0}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/ncaab-odds.html#query-any-ncaab-markets)\ Query Any NCAAB Markets\ \ Any supported NCAAB markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current NCAAB odds for any market, including player props, half and quarter time markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `basketball_ncaab`\ * **eventId**   This example uses the id of Saint Louis Billikens @ Loyola (Chi) Ramblers (id 9d4a4...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_h1` (1st half moneyline), `player_points`, `player_rebounds`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/basketball_ncaab/events/9d4a4c158fb7ee8ac579ea4d16eb4633/odds?regions=us2&markets=h2h_h1,player_points,player_rebounds&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified NCAAB game including odds from the specified bookmakers and markets.\ \ {\ "id": "9d4a4c158fb7ee8ac579ea4d16eb4633",\ "sport_key": "basketball_ncaab",\ "sport_title": "NCAAB",\ "commence_time": "2025-02-15T00:00:00Z",\ "home_team": "Loyola (Chi) Ramblers",\ "away_team": "Saint Louis Billikens",\ "bookmakers": [\ {\ "key": "espnbet",\ "title": "ESPN BET",\ "markets": [\ {\ "key": "h2h_h1",\ "last_update": "2025-02-14T23:20:13Z",\ "outcomes": [\ {"name": "Loyola (Chi) Ramblers", "price": -140},\ {"name": "Saint Louis Billikens", "price": 110}\ ]\ },\ {\ "key": "player_points",\ "last_update": "2025-02-14T23:20:13Z",\ "outcomes": [\ {"name": "Over", "description": "Robbie Avila", "price": 105, "point": 16.5},\ {"name": "Under", "description": "Robbie Avila", "price": -150, "point": 16.5},\ {"name": "Over", "description": "Gibson Jimerson", "price": 115, "point": 16.5},\ {"name": "Under", "description": "Gibson Jimerson", "price": -165, "point": 16.5},\ ...\ ]\ },\ {\ "key": "player_rebounds",\ "last_update": "2025-02-14T23:20:13Z",\ "outcomes": [\ {"name": "Over", "description": "Kalu Anya", "price": -135, "point": 7.5},\ {"name": "Under", "description": "Kalu Anya", "price": -105, "point": 7.5},\ {"name": "Over", "description": "Robbie Avila", "price": -185, "point": 5.5},\ {"name": "Under", "description": "Robbie Avila", "price": 130, "point": 5.5},\ ...\ ]\ }\ ]\ }\ ...\ \ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/ncaab-odds.html#other-sports)\ Other Sports\ -------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/ncaab-odds.html#stay-updated)\ Stay Updated\ -------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NFL Odds API | The Odds API [#](https://the-odds-api.com/sports/nfl-odds.html#nfl-odds-api) NFL Odds API ============================================================================= The Odds API covers NFL odds for live and upcoming games in a simple JSON API. Not a developer? Current NFL odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/nfl-odds.html#features) Features --------------------------------------------------------------------- * NFL odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, half and quarter time markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * NFL scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NFL odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/nfl-odds.html#querying-nfl-odds) Querying NFL Odds --------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/nfl-odds.html#query-featured-nfl-markets) Query Featured NFL Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current NFL odds for featured markets, the following parameters need to be provided: * **sport**   In this case `americanfootball_nfl` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NFL games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "2fd335893dbb8ab9c0e1aea6c98a969c",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2024-12-10T01:15:00Z",\ "home_team": "Dallas Cowboys",\ "away_team": "Cincinnati Bengals",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2024-12-09T23:54:52Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-12-09T23:54:52Z",\ "outcomes": [\ {"name": "Cincinnati Bengals", "price": -218},\ {"name": "Dallas Cowboys", "price": 180}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2024-12-09T23:54:52Z",\ "outcomes": [\ {"name": "Cincinnati Bengals", "price": -108, "point": -4.5},\ {"name": "Dallas Cowboys", "price": -112, "point": 4.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2024-12-09T23:54:52Z",\ "outcomes": [\ {"name": "Over", "price": -108, "point": 50.5},\ {"name": "Under", "price": -112, "point": 50.5}\ ]\ }\ ]\ },\ {\ "key": "williamhill_us",\ "title": "Caesars",\ "last_update": "2024-12-09T23:53:48Z",\ "markets": [\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/nfl-odds.html#query-any-nfl-markets)\ Query Any NFL Markets\ \ Any supported NFL markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current NFL odds for any market, including player props, half/quarter time markets, and more, the following parameters need to be provided:\ \ * **sport**   In this case `americanfootball_nfl`\ * **eventId**   This example uses the id of Bengals @ Cowboys (id 2fd3...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_q1` (1st quarter moneyline), `player_pass_tds`, `player_rush_yds`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events/2fd335893dbb8ab9c0e1aea6c98a969c/odds?regions=us&markets=h2h_q1,player_pass_tds,player_rush_yds&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified NFL game including odds from the specified bookmakers and markets.\ \ {\ "id": "2fd335893dbb8ab9c0e1aea6c98a969c",\ "sport_key": "americanfootball_nfl",\ "sport_title": "NFL",\ "commence_time": "2024-12-10T01:15:00Z",\ "home_team": "Dallas Cowboys",\ "away_team": "Cincinnati Bengals",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2024-12-09T23:54:52Z",\ "markets": [\ {\ "key": "h2h_q1",\ "last_update": "2024-12-09T23:55:33Z",\ "outcomes": [\ {"name": "Cincinnati Bengals", "price": -148},\ {"name": "Dallas Cowboys", "price": 124}\ ]\ },\ {\ "key": "player_pass_tds",\ "last_update": "2024-12-09T23:55:33Z",\ "outcomes": [\ {"name": "Over", "description": "Cooper Rush", "price": 110, "point": 1.5},\ {"name": "Under", "description": "Cooper Rush", "price": -145, "point": 1.5},\ {"name": "Over", "description": "Joe Burrow", "price": -235, "point": 1.5},\ {"name": "Under", "description": "Joe Burrow", "price": 180, "point": 1.5}\ ]\ },\ {\ "key": "player_rush_yds",\ "last_update": "2024-12-09T23:55:33Z",\ "outcomes": [\ {"name": "Over", "description": "Chase Brown", "price": -115, "point": 76.5},\ {"name": "Under", "description": "Chase Brown", "price": -115, "point": 76.5},\ {"name": "Over", "description": "Rico Dowdle", "price": -105, "point": 65.5},\ {"name": "Under", "description": "Rico Dowdle", "price": -125, "point": 65.5},\ {"name": "Over", "description": "Ezekiel Elliott", "price": -110, "point": 9.5},\ {"name": "Under", "description": "Ezekiel Elliott", "price": -120, "point": 9.5},\ ...\ \ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/nfl-odds.html#other-sports)\ Other Sports\ -----------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/nfl-odds.html#stay-updated)\ Stay Updated\ -----------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # NCAAF Odds API | The Odds API [#](https://the-odds-api.com/sports/ncaaf-odds.html#ncaaf-odds-api) NCAAF Odds API =================================================================================== The Odds API covers NCAAF (College Football) odds for live and upcoming games in a simple JSON API. Not a developer? Current NCAAF odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/ncaaf-odds.html#features) Features ----------------------------------------------------------------------- * NCAAF odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, half and quarter time markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * NCAAF scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical NCAAF odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from mid-2020. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/ncaaf-odds.html#querying-ncaaf-odds) Querying NCAAF Odds --------------------------------------------------------------------------------------------- ### [#](https://the-odds-api.com/sports/ncaaf-odds.html#query-featured-ncaaf-markets) Query Featured NCAAF Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current NCAAF odds for featured markets, the following parameters need to be provided: * **sport**   In this case `americanfootball_ncaaf` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/americanfootball_ncaaf/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming NCAAF games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "680b1441ea6113b9cc8f723ee1616f39",\ "sport_key": "americanfootball_ncaaf",\ "sport_title": "NCAAF",\ "commence_time": "2024-12-19T02:00:00Z",\ "home_team": "UNLV Rebels",\ "away_team": "California Golden Bears",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2024-12-18T23:55:22Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-12-18T23:55:22Z",\ "outcomes": [\ {"name": "California Golden Bears", "price": 134},\ {"name": "UNLV Rebels", "price": -162}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2024-12-18T23:55:22Z",\ "outcomes": [\ {"name": "California Golden Bears", "price": -115,"point": 3.5},\ {"name": "UNLV Rebels", "price": -105, "point": -3.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2024-12-18T23:55:22Z",\ "outcomes": [\ {"name": "Over", "price": -110, "point": 45.5},\ {"name": "Under", "price": -110, "point": 45.5}\ ]\ }\ ]\ },\ \ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/ncaaf-odds.html#query-any-ncaaf-markets)\ Query Any NCAAF Markets\ \ Any supported NCAAF markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current NCAAF odds for any market, including player props, innings markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `americanfootball_ncaaf`\ * **eventId**   This example uses the id of Bengals @ Cowboys (id 2fd3...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_q1` (1st quarter moneyline), `player_pass_tds`, `player_rush_yds`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/americanfootball_ncaaf/events/2fd335893dbb8ab9c0e1aea6c98a969c/odds?regions=us&markets=h2h_q1,player_pass_tds,player_rush_yds&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified NCAAF game including odds from the specified bookmakers and markets.\ \ {\ "id": "680b1441ea6113b9cc8f723ee1616f39",\ "sport_key": "americanfootball_ncaaf",\ "sport_title": "NCAAF",\ "commence_time": "2024-12-19T02:00:00Z",\ "home_team": "UNLV Rebels",\ "away_team": "California Golden Bears",\ "bookmakers": [\ {\ "key": "fanduel",\ "title": "FanDuel",\ "last_update": "2024-12-18T23:55:22Z",\ "markets": [\ {\ "key": "h2h_q1",\ "last_update": "2024-12-18T23:54:47Z",\ "outcomes": [\ {"name": "California Golden Bears", "price": 112},\ {"name": "UNLV Rebels", "price": -142}\ ]\ },\ {\ "key": "player_pass_tds",\ "last_update": "2024-12-18T23:54:38Z",\ "outcomes": [\ {"name": "Over", "description": "Hajj-Malik Williams", "price": 154, "point": 1.5},\ {"name": "Under", "description": "Hajj-Malik Williams", "price": -196, "point": 1.5}\ ]\ },\ {\ "key": "player_rush_yds",\ "last_update": "2024-12-18T23:54:47Z",\ "outcomes": [\ {"name": "Over", "description": "Jai'Den Thomas", "price": -112, "point": 55.5},\ {"name": "Under", "description": "Jai'Den Thomas", "price": -112, "point": 55.5},\ {"name": "Over", "description": "Jaydn Ott", "price": -112, "point": 54.5},\ {"name": "Under", "description": "Jaydn Ott", "price": -112, "point": 54.5},\ {"name": "Over", "description": "Hajj-Malik Williams", "price": -112, "point": 64.5},\ {"name": "Under", "description": "Hajj-Malik Williams", "price": -112, "point": 64.5}\ ]\ }\ ]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/ncaaf-odds.html#other-sports)\ Other Sports\ -------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/ncaaf-odds.html#stay-updated)\ Stay Updated\ -------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # WNBA Odds API | The Odds API [#](https://the-odds-api.com/sports/wnba-odds.html#wnba-odds-api) WNBA Odds API ================================================================================ The Odds API covers WNBA odds for live and upcoming games in a simple JSON API. Not a developer? Current WNBA odds can also be accessed in [Excel](https://the-odds-api.com/features/excel.html) or [Google Sheets](https://the-odds-api.com/features/spreadsheets.html) . For website owners, the [odds widget](https://the-odds-api.com/widget/) brings bookmaker odds into websites with a simple HTML tag. [#](https://the-odds-api.com/sports/wnba-odds.html#features) Features ---------------------------------------------------------------------- * WNBA odds are covered for live and upcoming games. * Featured markets, including moneyline, spreads, totals are covered for several bookmakers. See the [full list of bookmakers](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html) . * Additional markets including player props, quarter and half time markets, and more are covered for most US bookmakers. See the [full list of betting markets](https://the-odds-api.com/sports-odds-data/betting-markets.html) . * Odds are refreshed at regular intervals. More information on update intervals can be [found here](https://the-odds-api.com/sports-odds-data/update-intervals.html) . * WNBA scores are covered, with final scores available for games completed up to 3 days ago. * Current odds data and scores are available on all usage plans, including the [free usage plan](https://the-odds-api.com/#get-access) . * Historical WNBA odds data is available on paid usage plans. Historical odds for featured markets (moneyline, spreads, totals) are available from May 2022. Historical odds for other markets are available from May 2023. More information on historical odds data can be [found here](https://the-odds-api.com/historical-odds-data/) . * The API response includes [deep links](https://the-odds-api.com/releases/deep-links.html) to bookmaker websites. * [Rotation numbers](https://the-odds-api.com/releases/rotation-numbers.html) are included in the API response. [#](https://the-odds-api.com/sports/wnba-odds.html#querying-wnba-odds) Querying WNBA Odds ------------------------------------------------------------------------------------------ ### [#](https://the-odds-api.com/sports/wnba-odds.html#query-featured-wnba-markets) Query Featured WNBA Markets Featured markets (moneyline, spreads and totals) can be queried using the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds) . For additional markets including player props, use the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds) . **Parameters** To query current WNBA odds for featured markets, the following parameters need to be provided: * **sport**   In this case `basketball_wnba` * **regions**   Regions of bookmakers to return, for example `us` * **markets**   For example, `h2h` for moneyline, `spreads` and `totals` * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access) See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-odds) for more options **Example API Request** https://api.the-odds-api.com/v4/sports/basketball_wnba/odds?regions=us&markets=h2h,spreads,totals&oddsFormat=american&apiKey=YOUR_API_KEY **Example API Response** The API will return live and upcoming WNBA games, including start times, home and away teams, and odds from bookmakers for the specified regions and markets. [{\ "id": "5e96dc974251332e31fddb60cda00fe9",\ "sport_key": "basketball_wnba",\ "sport_title": "WNBA",\ "commence_time": "2024-06-20T23:00:00Z",\ "home_team": "New York Liberty",\ "away_team": "Los Angeles Sparks",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2024-06-20T20:20:03Z",\ "markets": [\ {\ "key": "h2h",\ "last_update": "2024-06-20T20:20:03Z",\ "outcomes": [\ {"name": "Los Angeles Sparks", "price": 800},\ {"name": "New York Liberty", "price": -1350}\ ]\ },\ {\ "key": "spreads",\ "last_update": "2024-06-20T20:20:03Z",\ "outcomes": [\ {"name": "Los Angeles Sparks", "price": -112, "point": 14.5},\ {"name": "New York Liberty", "price": -108, "point": -14.5}\ ]\ },\ {\ "key": "totals",\ "last_update": "2024-06-20T20:20:03Z",\ "outcomes": [\ {"name": "Over", "price": -110, "point": 166.5},\ {"name": "Under", "price": -110, "point": 166.5}\ ]\ }\ ]},\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/)\ for details.\ \ ### [#](https://the-odds-api.com/sports/wnba-odds.html#query-any-wnba-markets)\ Query Any WNBA Markets\ \ Any supported WNBA markets can be queried one game at a time using the [event-odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ .\ \ **Parameters**\ \ To query current WNBA odds for any market, including player props, half and quarter time markets and more, the following parameters need to be provided:\ \ * **sport**   In this case `basketball_wnba`\ * **eventId**   This example uses the id of Sparks @ Liberty (id 5e96...). A list of current event ids can be queried using the [events endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-events)\ .\ * **regions**   Regions of bookmakers to return, for example `us`\ * **markets**   For example `h2h_h1` (1st half moneyline), `player_points`, `player_rebounds`\ * **apiKey**   Get a [free API key](https://the-odds-api.com/#get-access)\ \ \ See [the documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for more options.\ \ **Example API Request**\ \ https://api.the-odds-api.com/v4/sports/basketball_wnba/events/5e96dc974251332e31fddb60cda00fe9/odds?regions=us2&markets=h2h_h1,player_points,player_rebounds&oddsFormat=american&apiKey=YOUR_API_KEY\ \ \ **Example API Response**\ \ The response will contain the specified WNBA game including odds from the specified bookmakers and markets.\ \ {\ "id": "5e96dc974251332e31fddb60cda00fe9",\ "sport_key": "basketball_wnba",\ "sport_title": "WNBA",\ "commence_time": "2024-06-20T23:00:00Z",\ "home_team": "New York Liberty",\ "away_team": "Los Angeles Sparks",\ "bookmakers": [\ {\ "key": "draftkings",\ "title": "DraftKings",\ "last_update": "2024-06-20T20:20:03Z",\ "markets": [\ {\ "key": "h2h_h1",\ "last_update": "2024-06-20T20:20:35Z",\ "outcomes": [\ {"name": "Los Angeles Sparks", "price": 525},\ {"name": "New York Liberty", "price": -750}\ ]\ },\ {\ "key": "player_points",\ "last_update": "2024-06-20T20:20:35Z",\ "outcomes": [\ {"name": "Over", "description": "Betnijah Laney-Hamilton", "price": -105, "point": 12.5},\ {"name": "Under", "description": "Betnijah Laney-Hamilton", "price": -125, "point": 12.5},\ {"name": "Over", "description": "Breanna Stewart", "price": -115, "point": 19.5},\ {"name": "Under", "description": "Breanna Stewart", "price": -115, "point": 19.5},\ ...\ ]\ },\ {\ "key": "player_rebounds",\ "last_update": "2024-06-20T20:20:35Z",\ "outcomes": [\ {"name": "Over", "description": "Betnijah Laney-Hamilton", "price": -125, "point": 4.5},\ {"name": "Under", "description": "Betnijah Laney-Hamilton", "price": -105, "point": 4.5},\ {"name": "Over", "description": "Breanna Stewart", "price": 100, "point": 9.5},\ {"name": "Under", "description": "Breanna Stewart", "price": -130, "point": 9.5},\ ...\ }]\ },\ ...\ \ The usage cost of the API call in this example is\ \ usage cost = [number of markets] x [number of regions] = 3 x 1 = 3 credits\ \ \ If you only need featured markets (moneyline, spreads, totals), it will be more cost-efficient to query the [odds endpoint](https://the-odds-api.com/liveapi/guides/v4/#get-odds)\ since it will return multiple games.\ \ See the [API documentation](https://the-odds-api.com/liveapi/guides/v4/#get-event-odds)\ for details.\ \ [#](https://the-odds-api.com/sports/wnba-odds.html#other-sports)\ Other Sports\ ------------------------------------------------------------------------------\ \ See the [full list of sports](https://the-odds-api.com/sports-odds-data/sports-apis.html)\ covered by The Odds API.\ \ [#](https://the-odds-api.com/sports/wnba-odds.html#stay-updated)\ Stay Updated\ ------------------------------------------------------------------------------\ \ Follow us on [X.com](https://twitter.com/The_Odds_API)\ or [Bluesky](https://bsky.app/profile/oddsapi.bsky.social)\ to stay updated on new sports, bookmakers, markets and features. --- # The Odds API Redirecting to [https://dash.the-odds-api.com/](https://dash.the-odds-api.com/) ... --- # The Odds API Redirecting to [https://dash.the-odds-api.com/](https://dash.the-odds-api.com/) ... ---