# Historical Odds Data BETA
Historical odds data is now available for all sports and bookmakers by The Odds API, for featured markets.
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®ions=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®ions=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®ions=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®ions=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®ions=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.