HIhighlightly
Football.Odds

Get all odds

Prematch odds refresh interval: Multiple times a day

Live odds refresh interval: Once every 10 minutes

Note: Endpoint is not available in the Basic/Free plan.

Retrieve a list of match odds based on the requested query parameters. With oddsType query parameter you can specify whether you want prematch or live odds. If you do not set a specific value prematch odds will be returned.

At least one primary query parameter needs to be specified before you can retrieve the data (timezone, limit, offset, oddsType are considered secondary).

The most popular way of getting match odds is by specifying the matchId query parameter. You can also utilise the date parameter alongside the timezone to fetch all match odds for a given day. By specifying league or bookmaker related fields you can further narrow down your search.

As it stands, we currently offer the support for the following markets:

MarketDescription
Full Time ResultThe possible outcomes for the mentioned market are Home, Draw or Away.
Asian HandicapThis is considered a complex market. It is split into multiple possible variants such as "Asian Handicap -1.25/+1.25", "Asian Handicap -1.5/+1.5" and so on. The possible outcome of a variant is either Home or Away.
Odd or EvenThe Odd or Even market defines whether the score of both teams will be either Odd or Even.
Total GoalsThis is considered a complex market. It is split into multiple possible variants such as "Total Goals 2", "Total Goals 3.5" and so on. The possible outcome of a variant is either Over or Under.
Both Teams to ScoreThe market defines whether both teams will score or not. Outcomes can be either Yes or No.
Correct ScoreThis is considered a complex market. It is split into multiple possible variants such as "Correct Score 2 : 0", "Correct Score 1 : 1" and so on. There is only a single possible outcome of the variant.
First Team to ScoreThe market defines which team will be the first one to score a goal. Outcomes can be either Home, Away or None when no team scores a goal.
Total CardsThis is considered a complex market. It is split into multiple possible variants such as "Total Cards 4", "Total Cards 5.25" and so on. The possible outcome of a variant is either Over or Under.
Clean SheetThe Clean Sheet market defines whether the home or away team will not concede any goals. Outcomes can be either Home or Away. If the game results in a 0 : 0 score, both outcomes are considered winning.
Total CornersThis is considered a complex market. It is split into multiple possible variants such as "Total Corners 11.5", "Total Corners 12.5" and so on. The possible outcome of a variant is either Over or Under.

There are two other important query parameters. The limit parameter defines what the number of returned match odds will be. If the number of actual match odds is above the limit value you can make subsequent requests by increasing the offset value.

Match odds are available up to 28 days after the game finishes and up to 7 days before the game starts.

Below is an example of what can be achieved with bookmaker odds on a match basis:

Odds example

get/football/odds

Request

Query parameters

oddsTypestring
Example:prematch

Defines whether live or prematch odds will be returned.

leagueIdnumber
leagueNamestring
timezonestring
Example:Europe/London

Valid timezone identifier.

bookmakerIdnumber
Example:1
limitnumber
Example:5
offsetnumber
matchIdnumber
bookmakerNamestring
Example:Stake.com
datestring

Date that follows the YYYY-MM-DD format.

Headers

x-rapidapi-hoststring required

sport-highlights-api.p.rapidapi.com

x-rapidapi-keystring required

Rapid API Token

Response

Example response

{
  "data": [
    {
      "matchId": 884822928,
      "odds": [
        {
          "bookmakerId": 1,
          "bookmakerName": "Stake.com",
          "type": "prematch",
          "market": "Full Time Result",
          "values": [
            {
              "odd": 6.6,
              "value": "Home"
            }
          ]
        }
      ]
    }
  ],
  "pagination": {
    "totalCount": 490,
    "offset": 20,
    "limit": 100
  },
  "plan": {
    "tier": "BASIC",
    "message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.