# Historical Odds Data BETA

Historical odds data is now available for all sports, bookmakers and markets covered by The Odds API.

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.

At present, historical odds data is only available on paid usage plans.

# How to access historical odds data

Historical odds data is available in JSON format from the odds-history endpoint in the API. For more details, see the historical odds API docs. The usage quota cost for historical odds is currently 10 per region per market (more info).

# Example API Request

The input parameters are the same as those of the v4 odds API endpoint, with the addition of a date parameter which is used to indicate the time of the snapshot of data. The historical odds API will return the closest snapshot equal to or earlier than the provided date parameter. The usage quota cost for historical odds endpoint is currently 10 per region per market.

GET https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds-history?regions=us&oddsFormat=american&apiKey=YOUR_API_KEY&date=2021-10-18T12:00:00Z

# Example API Response

The response schema is the same as that of the v4 odds API endpoint, 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
                                }
                            ]
                        }
                    ]
                },
                ...

The usage quota cost for a historical odds endpoint request is currently 10 per region per market (more info).

# Currently in Beta

The historical odds API is currently available in beta mode, which means we are still testing the performance of the API, data quality, and user requirements. If you have any feedback, we would love to hear it at team@the-odds-api.com

# 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).

# 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/sports/americanfootball_nfl/odds-history?apiKey=YOUR_API_KEY&regions=us&markets=h2h,spreads,totals&oddsFormat=american&date=2021-11-25T12:00:00Z

Response: Download historical odds API response for NFL

# 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/sports/soccer_epl/odds-history?apiKey=YOUR_API_KEY&regions=uk&markets=h2h&date=2021-10-30T00:00:00Z

Response: Download historical odds API response for EPL

# 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/sports/soccer_germany_bundesliga/odds-history?apiKey=YOUR_API_KEY&regions=eu&markets=h2h&date=2022-10-18T02:00:00Z

Response: Download historical odds API response for Bundesliga

# 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/sports/aussierules_afl/odds-history?apiKey=YOUR_API_KEY&regions=au&markets=h2h&date=2022-04-25T00:00:00Z

Response: Download historical odds API response for AFL

# 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/sports/politics_us_presidential_election_winner/odds-history?apiKey=YOUR_API_KEY&regions=us&oddsFormat=american&date=2020-10-31T00:00:00Z

Response: Download historical odds API response for US Presidential Election Winner

# Get Access

Historical odds data is only available for paid subscriptions at this time. Get an API key by subscribing to a usage plan.

Alternatively subscriptions can be managed in the accounts portal.