Live Odds Changes (Main)

Update Time: 2026-06-18 11:35

Introduction

• This API endpoint returns real-time odds changes for major market types (Handicap, Europe Odds, and Over/Under) that occurred within the last 20 seconds.

• Data is delivered incrementally in a high-efficiency format, using comma-separated strings within arrays to represent various odds parameters and flags.

• Use it alongside the Pre-match and In-play Odds (Main) endpoint to synchronize and maintain a real-time local odds database.

Related Plans

You can use this api by subscribing plans:  Odds,  Odds Pro.

Request

  • Path: /sport/football/odds/main/changes
  • Method: GET
  • Calls: This interface is limited to 1 second/call;
  • Recommend Calls: 2 second/call
  • Parameters:
ParameterValueRequiredDescription
matchIdstringfalseFilter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request.
companyIdstringfalseFilter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=3,8).

Response

ParameterValueDescription
handicap string arrayAsian Handicap odds. Each entry is a comma-separated string containing the fields below.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwetten
22: 10BET
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
48: HK Jockey Club
instantHandicap stringCurrent handicap line.

Positive = home team gives goals (e.g., 1 = home −1).
Negative = away team gives goals (e.g., -1 = home +1). Quarter lines as decimals (e.g., 1.25 = 1/1.5).
instantHome string Current Asian Handicap odds — home side (Hong Kong Odds)
instantAway string Current Asian Handicap odds — away side (Hong Kong Odds)
maintenance booleantrue: Odds temporarily suspended due to system maintenance
false: Normal
inPlay booleantrue: In-play odds available
false: Pre-match only
changeTime intTimestamp of the last odds update (Unix timestamp, GMT+0)
close booleantrue: Betting is closed
false: Betting is open.

Supported by selected bookmakers only — see Introduction.
Odds Type smallintOdds stage
0: Unable to determine
1: Early odds
2: Pre-match closing odds (after early odds, before kick-off)
3: In-play odds
europeOdds string array1X2 odds. Each entry is a comma-separated string containing the fields below.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwetten
22: 10BET
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
48: HK Jockey Club
instantHome string Current 1X2 odds — home win (Hong Kong Odds)
instantDraw string Current 1X2 odds — draw (Hong Kong Odds)
instantAway string Current 1X2 odds — away win (Hong Kong Odds)
changeTime intTimestamp of the last odds update (Unix timestamp, GMT+0)
close booleantrue: Betting is closed
false: Betting is open.

Supported by selected bookmakers only — see Introduction.
Odds Type smallintOdds stage
0: Unable to determine
1: Early odds
2: Pre-match closing odds (after early odds, before kick-off)
3: In-play odds
overUnder string arrayOver/under odds. Each entry is a comma-separated string containing the fields below.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwetten
22: 10BET
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
48: HK Jockey Club
instantHandicap stringCurrent over/under line.

Positive integer = exact goal total (e.g., 1 = 1 goal). Quarter lines as decimals (e.g., 1.25 = 1/1.5).
instantOver string Current over odds (Hong Kong Odds)
instantUnder string Current under odds (Hong Kong Odds)
changeTime intTimestamp of the last odds update (Unix timestamp, GMT+0)
close booleantrue: Betting is closed
false: Betting is open.

Supported by selected bookmakers only — see Introduction.
Odds Type smallintOdds stage
0: Unable to determine
1: Early odds
2: Pre-match closing odds (after early odds, before kick-off)
3: In-play odds
handicapHalf string arrayFirst-half Asian Handicap odds. Each entry is a comma-separated string containing the fields below.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwetten
22: 10BET
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
48: HK Jockey Club
instantHandicap stringCurrent first-half handicap line. n
Positive = home team gives goals (e.g., 1 = home −1).
Negative = away team gives goals (e.g., -1 = home +1). Quarter lines as decimals (e.g., 1.25 = 1/1.5).
instantHome string Current first-half Asian Handicap odds — home side (Hong Kong Odds)
instantAway string Current first-half Asian Handicap odds — away side (Hong Kong Odds)
changeTime intTimestamp of the last odds update (Unix timestamp, GMT+0)
Odds Type smallintOdds stage
0: Unable to determine
1: Early odds
2: Pre-match closing odds (after early odds, before kick-off)
3: In-play odds
overUnderHalf string arrayFirst-half over/under odds. Each entry is a comma-separated string containing the fields below.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwetten
22: 10BET
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
48: HK Jockey Club
instantHandicap stringCurrent first-half over/under line.

Positive integer = exact goal total (e.g., 1 = 1 goal). Quarter lines as decimals (e.g., 1.25 = 1/1.5).
instantOver string Current first-half over odds (Hong Kong Odds)
instantUnder string Current first-half under odds (Hong Kong Odds)
changeTime intTimestamp of the last odds update (Unix timestamp, GMT+0)
Odds Type smallintOdds stage
0: Unable to determine
1: Early odds
2: Pre-match closing odds (after early odds, before kick-off)
3: In-play odds

Example Request

Example Response

    • This API endpoint returns real-time odds changes for major market types (Handicap, Europe Odds, and Over/Under) that occurred within the last 20 seconds.\n\n

• Data is delivered incrementally in a high-efficiency format, using comma-separated strings within arrays to represent various odds parameters and flags.\n\n

• Use it alongside the Pre-match and In-play Odds (Main) endpoint to synchronize and maintain a real-time local odds database.
    Contact
    Contact
    BLOG
    England's Ghana draw is a reality check after Croatia thrillMessi breaks the World Cup scoring record in another immortal Argentina displayMbappe double sends France through after weather-hit win over Iraq
    Read More
    Products
    Football APIBasketball APIWidgets
    Getting Started
    IntroductionFAQAPI Docs
    About
    About UsWhy Choose iSportsTerms of ServicePrivacy PolicySitemap
    Resources
    SupportContact
    iSports API logo
    COPYRIGHT © 2026 ISPORTS API. ALL RIGHTS RESERVED.