# FIFA World Cup Odds API

The Odds API covers World Cup odds for live and upcoming matches in a simple JSON API.

Not a developer? Current World Cup 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

World Cup 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.
Odds are refreshed at regular intervals. More information on update intervals can be found here.
World Cup 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.
Historical World Cup odds data is available on paid usage plans. Historical odds for 1X2 are available from April 2022. More information on historical odds data can be found here.
The API response includes deep links to bookmaker websites.

# Querying World Cup Odds

# Query Featured World Cup Markets

Featured markets (1X2, handicap and totals) can be queried using the odds endpoint. For additional markets including player props, use the event-odds endpoint.

Parameters

To query current World Cup odds for featured markets, the following parameters need to be provided:

sport In this example soccer_fifa_world_cup
regions Regions of bookmakers to return, for example eu
markets For example, h2h for 1X2, spreads for handicap, and totals for over/under
oddsFormat Format of returned odds, can be decimal or american. This example uses decimal
apiKey Get a free API key

See the documentation for more options

Example API Request

https://api.the-odds-api.com/v4/sports/soccer_fifa_world_cup/odds?regions=eu&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY

Example API Response

The API will return live and upcoming World Cup matches, including start times, home and away teams, and odds from bookmakers for the specified regions and markets.

[
    {
        "id": "32ec06abda2398ac41501c86eb9aa376",
        "sport_key": "soccer_fifa_world_cup",
        "sport_title": "FIFA World Cup",
        "commence_time": "2026-06-14T20:00:00Z",
        "home_team": "Netherlands",
        "away_team": "Japan",
        "bookmakers": [
            {
                "key": "pinnacle",
                "title": "Pinnacle",
                "last_update": "2026-04-14T02:35:43Z",
                "markets": [
                    {
                        "key": "h2h",
                        "last_update": "2026-04-14T02:35:43Z",
                        "outcomes": [
                            {"name": "Japan", "price": 3.6},
                            {"name": "Netherlands", "price": 1.97},
                            {"name": "Draw", "price": 3.6}
                        ]
                    },
                    {
                        "key": "spreads",
                        "last_update": "2026-04-14T02:35:43Z",
                        "outcomes": [
                            {"name": "Japan", "price": 1.84, "point": 0.5},
                            {"name": "Netherlands", "price": 1.98, "point": -0.5}
                        ]
                    },
                    {
                        "key": "totals",
                        "last_update": "2026-04-14T02:35:43Z",
                        "outcomes": [
                            {"name": "Over", "price": 1.88, "point": 2.5},
                            {"name": "Under", "price": 1.93, "point": 2.5}
                        ]
                    }
                ]
            },
            {
                "key": "betfair_ex_eu",
                "title": "Betfair",
                "last_update": "2026-04-14T02:35:43Z",
                "markets": [
                    {
                        "key": "h2h",
                        "last_update": "2026-04-14T02:35:43Z",
                        "outcomes": [
                            {"name": "Japan", "price": 3.7},
                            {"name": "Netherlands", "price": 1.98},
                            {"name": "Draw", "price": 3.75}
                        ]
                    },
                    ...

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 for details.

# Query Any World Cup Market

Any supported World Cup market can be queried one match at a time using the event-odds endpoint.

Parameters

To query current World Cup odds for any market, including player props, innings markets and more, the following parameters need to be provided:

sport In this case soccer_fifa_world_cup
eventId This example uses the ID of South Korea v Czech Republic (id 384c...). A list of current event IDs can be queried using the events endpoint.
regions Regions of bookmakers to return, for example uk
markets For example btts (both teams to score), alternate_totals, player_goal_scorer_anytime
apiKey Get a free API key

See the documentation for more options.