Odds

Retrieve match odds.

Prematch refresh

Multiple times a day

Live refresh

Once every 10 minutes

Plan

Not available on Basic/Free

Pagination

limit and offset, 5 per page

Prematch or live

oddsType selects between prematch and live odds. Omit it and you get prematch.

The two refresh at very different rates. Prematch odds update multiple times a day, live odds every ten minutes, so polling live odds faster than that spends quota without returning anything new.

Querying

At least one primary query parameter must be specified. timezone, limit, offset and oddsType are secondary and do not count on their own.

The most common approach is matchId, which returns the odds for one fixture. Alternatively use date with timezone to fetch all odds for a given day. League and bookmaker filters narrow it further, and bookmaker ids come from bookmakers.

Supported markets

A complex market is split into variants, such as "Total Goals 8" and "Total Goals 8.5", so do not assume one entry per market. Each Correct Score variant has a single possible outcome.

How odds are grouped

Results are grouped by match. Each entry in data holds a matchId and an odds list, and every item in that list carries bookmakerId, type (prematch or live), market and its values. bookmakerName is optional.

Each value is a label in value and a price in odd, so the 3-Way Moneyline market arrives as Home, Draw and Away.

Because every item names its bookmaker, one match can carry the same market from several bookmakers, which is what lets you compare prices. If you only display one bookmaker, filter by bookmakerId when you request rather than after.

Parameters

Request

curl --request GET \
  --url 'https://hockey.highlightly.net/odds?oddsType=prematch&bookmakerId=19' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

const params = new URLSearchParams({
  oddsType: 'prematch',
  bookmakerId: '19'
})
const response = await fetch(`https://hockey.highlightly.net/odds?${params}`, {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()

import os
import requests

response = requests.get(
    'https://hockey.highlightly.net/odds',
    params={
        'oddsType': 'prematch',
        'bookmakerId': '19',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

Example response

{
  "data": [
    {
      "matchId": 295119925,
      "odds": [
        {
          "bookmakerId": 19,
          "bookmakerName": "1Bet",
          "type": "prematch",
          "market": "3-Way Moneyline",
          "values": [
            {
              "odd": 2.2,
              "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"
  }
}

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors