HIhighlightly
Baseball.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
Home/AwayThe possible outcomes for the mentioned market are either Home or Away. There is no possible way for the game to end in a Draw.
Over/UnderThis is considered a complex market. It is split into multiple possible variants such as "Over/Under 7.5", "Over/Under 9.5" points and so on. The possible outcome of a variant is either Over or Under.
Asian HandicapThis is considered a complex market. It is split into multiple possible variants such as "Asian Handicap -0.5/+0.5", "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.

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

Request

Query parameters

oddsTypestring
Example:prematch

Defines whether live or prematch odds will be returned.

leagueNamestring
Example:MLB
timezonestring
Example:Europe/London

Valid timezone identifier.

bookmakerIdnumber
Example:7122
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": 394,
      "odds": [
        {
          "bookmakerId": 53,
          "bookmakerName": "Megapari Sport",
          "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.