# 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 or Google Sheets. For website owners, the odds widget brings bookmaker odds into websites with a simple HTML tag.

# 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.
Odds are refreshed at regular intervals. More information on update intervals can be found here.
Current odds data are available on all usage plans, including the free usage plan.
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.
The API response includes deep links to bookmaker websites.

# Covered Tennis Tournaments

League / Tournament	Sport Key (use in the API)	Earliest 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

# Querying Tennis Odds

# Query Featured Tennis Markets

Featured markets, including match winner, game spreads and game totals odds can be queried using the odds endpoint.

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

See the documentation 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 for details.

# Other Sports