iSports API – Sports API Documentation & Example Responses for Developers

Pre-match Odds (Halftime)

Thời gian cập nhật: 2026-07-03 15:18

Introduction

• This interface returns pre-match odds for the halftime (1st half) Spread and Total markets of basketball matches. Values reflect halftime-specific lines only, not full-match odds.

• Returns data for all matches that have not yet started, as well as matches currently in play. For matches in play, the instant* fields retain the last pregame value recorded before kickoff and do not update with live/in-play odds movement (see field notes below).

• Odds type corresponds to company ID and company name:
- Spread/Money Line（1x2 Odds）
1: Marcauslot；2: Easybet；3: Crown；8: Bet365；9：Vcbet；10： William Hill；19：Interwetten；20：Ladbrokes；31: Sbobet；24: 12bet; 30：China Sports Lottery; 49:BWin；
-Total
4：Marcauslot；5: Easybet；6：Crown；11:Bet365；12：Vcbet；13： William Hill；22：Interwetten；23：Ladbrokes；34:Sbobet；27:12bet; 33: China Sports Lottery; 52: BWin

• Note: company ID numbering differs between the Spread and Total sections for the same bookmaker (e.g., Bet365 is 8 for Spread, 11 for Total). Always match the ID against the correct section.

• By using endpoints Schedule & Results (Basic) and Match Modify Record, you can get basic information of matches.

Related Plans

You can use this api by subscribing plans: Odds.

Request

Path: /sport/basketball/odds/half
Method: GET
Calls: This interface is limited to 10 seconds/call;
Recommend Calls: 1 minute/call

Response

Parameter		Value	Description
spread		string array	Each string contains all parameters below, separated by comma.
	matchId	string
	companyId	string	Company id for Spread: 1: Macauslot 2: Easybets 3: Crown 8: Bet365 9: Vcbet 10: William Hill 19: Interwetten 20: Ladbrokes 31: Sbobet 24: 12bet 30: China Sports Lottery 49: BWin
	initialHandicap	string	Opening handicap for the halftime spread market. This is the first line posted by the bookmaker for this match and does not change afterward.
	initialHome	string	Opening odds for the home team, corresponding to initialHandicap.
	initialAway	string	Opening odds for the away team, corresponding to initialHandicap.
	instantHandicap	string	Latest pregame handicap for the halftime spread market. Reflects the most recent line before kickoff; excludes in-play odds — does not update once the match is live.
	instantHome	string	Latest pregame odds for the home team, excluding in-play odds.
	instantAway	string	Latest pregame odds for the away team, excluding in-play odds.
total		string array	Each string contains all parameters below, separated by comma.
	matchId	string
	companyId	string	Company id for total: 4: Macauslot 5: Easybets 6: Crown 11: Bet365 12: Vcbet 13: William Hill 22: Interwetten 23: Ladbrokes 34: Sbobet 27: 12bet 33: China Sports Lottery 52: BWin
	initialHandicap	string	Opening total line (points) for the halftime total market.
	initialOver	string	Opening odds for Over, corresponding to initialHandicap.
	initialUnder	string	Opening odds for Under, corresponding to initialHandicap.
	instantHandicap	string	Latest pregame total line, excluding in-play odds.
	instantOver	string	Latest pregame odds for Over, excluding in-play odds.
	instantUnder	string	Latest pregame odds for Under, excluding in-play odds.

Example Request

Example Response

• This interface returns pre-match odds for the halftime (1st half) Spread and Total markets of basketball matches. Values reflect halftime-specific lines only, not full-match odds.\n\n • Returns data for all matches that have not yet started, as well as matches currently in play. For matches in play, the instant* fields retain the last pregame value recorded before kickoff and do not update with live/in-play odds movement (see field notes below).\n\n • Odds type corresponds to company ID and company name:\n - Spread/Money Line（1x2 Odds）\n 1: Marcauslot；2: Easybet；3: Crown；8: Bet365；9：Vcbet；10： William Hill；19：Interwetten；20：Ladbrokes；31: Sbobet；24: 12bet; 30：China Sports Lottery; 49:BWin；\n -Total\n 4：Marcauslot；5: Easybet；6：Crown；11:Bet365；12：Vcbet；13： William Hill；22：Interwetten；23：Ladbrokes；34:Sbobet；27:12bet; 33: China Sports Lottery; 52: BWin\n\n • Note: company ID numbering differs between the Spread and Total sections for the same bookmaker (e.g., Bet365 is 8 for Spread, 11 for Total). Always match the ID against the correct section.\n\n • By using endpoints Schedule & Results (Basic) and Match Modify Record, you can get basic information of matches.

Liên hệ