Skip to content

Africa Cup of Nations Odds API ​

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

Not a developer? Current Africa Cup of Nations 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 ​

  • Africa Cup of Nations 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.

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

  • Historical Africa Cup of Nations odds data is available from Jan 2022 on paid usage plans. More information on historical odds data can be found here.

  • The API response includes deep links to bookmaker websites.

Querying Africa Cup of Nations Odds ​

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

Parameters

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

  • sport   In this case soccer_africa_cup_of_nations. Data will only be returned when Africa Cup of Nations is in season
  • 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_africa_cup_of_nations/odds?regions=eu&markets=h2h,spreads,totals&oddsFormat=decimal&apiKey=YOUR_API_KEY

Example API Response

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

json
[{
    "id": "84ba0778ebc81a908a88a525f2478e82",
    "sport_key": "soccer_africa_cup_of_nations",
    "sport_title": "Africa Cup of Nations",
    "commence_time": "2025-12-27T12:30:00Z",
    "home_team": "Benin",
    "away_team": "Botswana",
    "bookmakers": [
        {
            "key": "pinnacle",
            "title": "Pinnacle",
            "last_update": "2025-12-27T11:55:28Z",
            "markets": [
                {
                    "key": "h2h",
                    "last_update": "2025-12-27T11:55:28Z",
                    "outcomes": [
                        {"name": "Benin", "price": 1.7},
                        {"name": "Botswana", "price": 6.49},
                        {"name": "Draw", "price": 3.31}
                    ]
                },
                {
                    "key": "spreads",
                    "last_update": "2025-12-27T11:55:28Z",
                    "outcomes": [
                        {"name": "Benin", "price": 1.95, "point": -0.75},
                        {"name": "Botswana", "price": 1.93, "point": 0.75}
                    ]
                },
                {
                    "key": "totals",
                    "last_update": "2025-12-27T11:55:28Z",
                    "outcomes": [
                        {"name": "Over", "price": 1.83, "point": 1.75},
                        {"name": "Under", "price": 2.06, "point": 1.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.

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.