The Odds API

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

# How to access historical odds data

Featured markets 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.

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

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
# 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
                                }
                            ]
                        }
                    ]
                },
                ...

# Historical odds data for additional markets

Historical odds data for 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.

# Example API Request

The input parameters are the same as those of the v4 event-odds API endpoint, 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).

In this example, da359da99aa27e97d38f2df709343998 is the id of the Lakers @ Pistons game on 2023-11-30. The historical events endpoint 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&regions=us&markets=player_points,h2h_q1
# Example API Response

The response schema is the same as that of the v4 event-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": "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
                            },
                            ...

# 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/historical/sports/americanfootball_nfl/odds?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/historical/sports/soccer_epl/odds?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/historical/sports/soccer_germany_bundesliga/odds?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/historical/sports/aussierules_afl/odds?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/historical/sports/politics_us_presidential_election_winner/odds?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

# 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 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 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
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
Ice Hockey NHL icehockey_nhl 2020-06-29T19:25:00Z
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 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 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

# Get Access

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

Subscriptions can also be managed in the accounts portal.

X.com • Bluesky • Github
Status • Terms • Privacy Policy • Contact
© 2025 The Odds API