HIhighlightly
NHL, NCAAH.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
3-Way MoneylineThe possible outcomes for the three-way moneyline market are Home, Draw or Away.
MoneylineWhen a match does not have a three-way moneyline it will have a two-way one instead. The possible outcomes for the mentioned market are either Home or Away. There is no possible way for the game to end in a Draw.
Total GoalsThis is considered a complex market. It is split into multiple possible variants such as "Total Goals 8", "Total Goals 8.5" and so on. The possible outcome of a variant is either Over or Under.
Odd or EvenThe Odd or Even market defines whether the score of both teams will be either Odd or Even.
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.

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/nhl/odds

Request

Query parameters

oddsTypestring
Example:prematch

Defines whether live or prematch odds will be returned.

leagueNamestring
Example:NHL
timezonestring
Example:Europe/London

Valid timezone identifier.

bookmakerIdnumber
Example:1
limitnumber
Example:5
offsetnumber
matchIdnumber
bookmakerNamestring
Example:22Bet
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": 1,
      "odds": [
        {
          "bookmakerId": 1,
          "bookmakerName": "Stake.com",
          "type": "prematch",
          "market": "Odd or Even",
          "values": [
            {
              "odd": 2.8,
              "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.