iSports API – Sports API Documentation & Example Responses for Developers

Live Odds Changes (All)

Update Time: 2026-06-29 16:04

Introduction

• This API endpoint returns all odds that changed in the past 20 seconds.

• You can use it with the Pre-match and In-play Odds (All) endpoint— call that endpoint once to get the full odds list, then poll this endpoint every 2 seconds to receive incremental updates.

Related Plans

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

Request

Path: /sport/football/odds/all/changes
Method: GET
Calls: This interface is limited to 1 second/call;
Recommend Calls: 2 seconds/call
Parameters:

Parameter	Value	Required	Description
matchId	string	false	Filter results to specific matches. Separate multiple IDs with "," (e.g., matchId=322964610,322964611). Maximum 100 match IDs per request.
companyId	string	false	Filter results to specific bookmakers. Separate multiple IDs with "," (e.g., companyId=3,8).

Response

Parameter		Value	Description
handicap		string array	Asian Handicap odds that changed in the past 20 seconds. Each entry is a comma-separated string containing the fields below.
	matchId	string
	companyId	string	1: 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	string	Current 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	boolean	true: Official data is under maintenance or experiencing an anomaly — data updates are temporarily paused false: Normal
	inPlay	boolean	true: In-play odds available false: Pre-match only
	handicapIndex	int	Index of this line among all lines offered by the bookmaker for this match (starting from 1). 1 represents the main market line.
	changeTime	int	Timestamp of this odds change (Unix timestamp, GMT+0)
	close	boolean	true: Betting is temporarily suspended or in-play has stopped false: Betting is open.
	Odds Type	smallint	Odds 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 array	1X2 odds that changed in the past 20 seconds. Each entry is a comma-separated string containing the fields below.
	matchId	string
	companyId	string	1: 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)
	handicapIndex	int	Always 1 for europeOdds, since there is only a single line for this market.
	changeTime	int	Timestamp of this odds change (Unix timestamp, GMT+0)
	close	boolean	true: Betting is temporarily suspended or in-play has stopped false: Betting is open.
	Odds Type	smallint	Odds 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 array	Over/under odds that changed in the past 20 seconds. Each entry is a comma-separated string containing the fields below.
	matchId	string
	companyId	string	1: 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	string	Current 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)
	handicapIndex	int	Index of this line among all lines offered by the bookmaker for this match (starting from 1). 1 represents the main market line.
	changeTime	int	Timestamp of this odds change (Unix timestamp, GMT+0)
	close	boolean	true: Betting is temporarily suspended or in-play has stopped false: Betting is open.
	Odds Type	smallint	Odds 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 array	First-half Asian Handicap odds that changed in the past 20 seconds. Each entry is a comma-separated string containing the fields below.
	matchId	string
	companyId	string	1: 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	string	Current first-half handicap line. Same format as handicap instantHandicap.
	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)
	inPlay	boolean	true: In-play odds available false: Pre-match only
	handicapIndex	int	Index of this line among all lines offered by the bookmaker for this match (starting from 1). 1 represents the main market line.
	changeTime	int	Timestamp of this odds change (Unix timestamp, GMT+0)
	Odds Type	smallint	Odds 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 array	First-half over/under odds that changed in the past 20 seconds. Each entry is a comma-separated string containing the fields below.
	matchId	string
	companyId	string	1: 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	string	Current first-half over/under line. Same format as overUnder instantHandicap.
	instantOver	string	Current first-half over odds (Hong Kong Odds)
	instantUnder	string	Current first-half under odds (Hong Kong Odds)
	handicapIndex	int	Index of this line among all lines offered by the bookmaker for this match (starting from 1). 1 represents the main market line.
	changeTime	int	Timestamp of this odds change (Unix timestamp, GMT+0)
	Odds Type	smallint	Odds 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 all odds that changed in the past 20 seconds. \n\n • You can use it with the Pre-match and In-play Odds (All) endpoint— call that endpoint once to get the full odds list, then poll this endpoint every 2 seconds to receive incremental updates.

Contact