iSports API – Sports API Documentation & Example Responses for Developers

Historical Odds (Main)

Update Time: 2026-06-26 15:31

Introduction

• This API endpoint returns historical opening and closing odds for major football betting markets.It defaults to records from GMT+0 0:00 today, while supporting a date parameter for historical back-checking up to one month.

• Handicap and over/under line format: Lines are multiples of 0.25.
0 = 0 goals, 0.25 = 0/0.5, 0.5 = 0.5, 0.75 = 0.5/1, 1 = 1 goal, and so on. A positive value means the home team gives goals; a negative value means the away team gives goals.

• Odds format: All odds values are returned in Hong Kong Odds format.
To convert to other formats: Decimal Odds = HK + 1 (e.g., 0.85 → 1.85); Malay Odds = HK if HK ≤ 1, or −(1 ÷ HK) if HK > 1 (e.g., 0.85 → 0.85, 1.5 → −0.67); Indonesian Odds = HK if HK ≥ 1, or −(1 ÷ HK) if HK < 1 (e.g., 0.85 → −1.18, 1.5 → 1.5); American Odds = HK × 100 if HK ≥ 1, or −(100 ÷ HK) if HK < 1 (e.g., 0.85 → −118, 1.5 → +150).

• The company ID corresponds to the company:
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, 49:Bwin, 50:1xbet

• close field: Only supported by selected bookmakers: Macauslot (1), Crown (3), Bet365 (8), Easybets (12), Mansion88 (17), 10BET (22), 12bet (24), Sbobet (31), Wewbet (35), 18bet (42).

Related Plans

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

Request

Path: /sport/football/odds/main/history
Method: GET
Calls: This interface is limited to 60 seconds/call;
Recommend Calls: 10 minutes/call
Parameters:

Parameter	Value	Required	Description
date	string	false	Filter results by date (GMT+0 00:00–23:59). Supports back-checking within the past month. Format: yyyy-MM-dd (e.g., date=2026-06-18). If omitted, returns data for the current day.
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

Note: Fields prefixed with initial represent opening odds (will not change). Fields prefixed with instant represent the latest odds (updated in real time).

Parameter		Value	Description
handicap		string array	Asian Handicap odds. 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
	initialHandicap	string	Opening 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).
	initialHome	string	Opening Asian Handicap odds — home side (Hong Kong Odds)
	initialAway	string	Opening Asian Handicap odds — away side (Hong Kong Odds)
	instantHandicap	string	Current handicap line. Same format as initialHandicap.
	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
	changeTime	int	Timestamp of the last odds update (Unix timestamp, GMT+0)
	close	boolean	true: Betting is temporarily suspended or in-play has stopped false: Betting is open.
europeOdds		string array	1X2 odds. 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
	initialHome	string	Opening 1X2 odds — home win (Hong Kong Odds)
	initialDraw	string	Opening 1X2 odds — draw (Hong Kong Odds)
	initialAway	string	Opening 1X2 odds — away win (Hong Kong Odds)
	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	int	Timestamp of the last odds update (Unix timestamp, GMT+0)
	close	boolean	true: Betting is temporarily suspended or in-play has stopped false: Betting is open.
overUnder		string array	Over/under odds. 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
	initialHandicap	string	Opening over/under line. Positive integer = exact goal total (e.g., 1 = 1 goal). Quarter lines as decimals (e.g., 1.25 = 1/1.5).
	initialOver	string	Opening over odds (Hong Kong Odds)
	initialUnder	string	Opening under odds (Hong Kong Odds)
	instantHandicap	string	Current over/under line. Same format as initialHandicap.
	instantOver	string	Current over odds (Hong Kong Odds)
	instantUnder	string	Current under odds (Hong Kong Odds)
	changeTime	int	Timestamp of the last odds update (Unix timestamp, GMT+0)
	close	boolean	true: Betting is temporarily suspended or in-play has stopped false: Betting is open.
handicapHalf		string array	First-half Asian Handicap odds. 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
	initialHandicap	string	Opening first-half handicap line. Same format as handicap initialHandicap.
	initialHome	string	Opening first-half Asian Handicap odds — home side (Hong Kong Odds)
	initialAway	string	Opening first-half Asian Handicap odds — away side (Hong Kong Odds)
	instantHandicap	string	Current first-half handicap line. Same format as initialHandicap.
	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	int	Timestamp of the last odds update (Unix timestamp, GMT+0)
overUnderHalf		string array	First-half over/under odds. 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
	initialHandicap	string	Opening first-half over/under line. Same format as overUnder initialHandicap.
	initialOver	string	Opening first-half over odds (Hong Kong Odds)
	initialUnder	string	Opening first-half under odds (Hong Kong Odds)
	instantHandicap	string	Current first-half over/under line. Same format as initialHandicap.
	instantOver	string	Current first-half over odds (Hong Kong Odds)
	instantUnder	string	Current first-half under odds (Hong Kong Odds)
	changeTime	int	Timestamp of the last odds update (Unix timestamp, GMT+0)

Example Request

Example Response

• This API endpoint returns historical opening and closing odds for major football betting markets.It defaults to records from GMT+0 0:00 today, while supporting a date parameter for historical back-checking up to one month.\n\n • Handicap and over/under line format: Lines are multiples of 0.25. \n 0 = 0 goals, 0.25 = 0/0.5, 0.5 = 0.5, 0.75 = 0.5/1, 1 = 1 goal, and so on. A positive value means the home team gives goals; a negative value means the away team gives goals.\n\n • Odds format: All odds values are returned in Hong Kong Odds format. \n To convert to other formats: Decimal Odds = HK + 1 (e.g., 0.85 → 1.85); Malay Odds = HK if HK ≤ 1, or −(1 ÷ HK) if HK > 1 (e.g., 0.85 → 0.85, 1.5 → −0.67); Indonesian Odds = HK if HK ≥ 1, or −(1 ÷ HK) if HK < 1 (e.g., 0.85 → −1.18, 1.5 → 1.5); American Odds = HK × 100 if HK ≥ 1, or −(100 ÷ HK) if HK < 1 (e.g., 0.85 → −118, 1.5 → +150).\n\n • The company ID corresponds to the company:\n 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, 49:Bwin, 50:1xbet\n\n • close field: Only supported by selected bookmakers: Macauslot (1), Crown (3), Bet365 (8), Easybets (12), Mansion88 (17), 10BET (22), 12bet (24), Sbobet (31), Wewbet (35), 18bet (42).

Contact