Skip to content

Copa del Rey Odds API ​

The Odds API covers Copa del Rey odds for live and upcoming matches in a simple JSON API.

Not a developer? Current Copa del Rey 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 ​

  • Copa del Rey 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.

  • Copa del Rey scores are covered, with final scores available for matches completed up to 3 days ago.

  • Current odds data and scores are available on all usage plans, including the free usage plan.

  • Historical Copa del Rey odds data is available from Feb 2026 on paid usage plans. More information on historical odds data can be found here.

  • The API response includes deep links to bookmaker websites.

Querying Copa del Rey Odds ​

Featured markets (1X2, handicap and over/under) can be queried using the odds endpoint.

Parameters

To query current Copa del Rey odds for featured markets, the following parameters need to be provided:

  • sport   In this case soccer_spain_copa_del_rey
  • regions   Regions of bookmakers to return, for example eu
  • markets   For example, h2h for 1X2, spreads for handicap, totals for over/under
  • oddsFormat   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_spain_copa_del_rey/odds?regions=eu&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY

Example API Response

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

json
[{
    "id": "50cbb38b1ea64b2bcae091b4385bab04",
    "sport_key": "soccer_spain_copa_del_rey",
    "sport_title": "Copa del Rey",
    "commence_time": "2026-11-12T18:00:00Z",
    "home_team": "Tarancón",
    "away_team": "Levante",
    "bookmakers": [
        {
            "key": "pinnacle",
            "title": "Pinnacle",
            "last_update": "2026-11-12T06:18:44Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2026-11-12T06:18:44Z",
                    "outcomes": [
                        {"name": "Levante", "price": 1.08},
                        {"name": "Tarancón", "price": 15.77},
                        {"name": "Draw", "price": 8.8}
                    ]
                },
                {
                    "key": "spreads",
                    "last_update": "2026-11-12T06:18:44Z",
                    "outcomes": [
                        {"name": "Levante", "price": 1.85, "point": -2.5},
                        {"name": "Tarancón", "price": 1.85, "point": 2.5}
                    ]
                },
                {
                    "key": "totals",
                    "last_update": "2026-11-12T06:18:44Z",
                    "outcomes": [
                        {"name": "Over", "price": 1.76, "point": 3.5},
                        {"name": "Under", "price": 1.93, "point": 3.5}
                    ]
                }
            ]
        },
        ...

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.

Other Sports ​

See the full list of sports covered by The Odds API.

Stay Updated ​

Follow us on X.com or Bluesky to stay updated on new sports, bookmakers, markets and features.