Historical Odds (Main)

Update Time: 2022-08-04 17:10

Introduction

• This API endpoint returns the historical initial and final odds data of the main market of the match.

• By default, it returns the match data from GMT+0 0:00 to the currently completed match.

• Data includes: handicap、handicapHalf、europeOdds、overUnder and overUnderHalf.

• Handicap and overUnder description:
-Handicap is an integer multiple of 0.25, 0 means "0 goal", 0.25 means "0/0.5 goal", 0.5 means "0.5 goal", 0.75 means "0.5/1 goal", 1 means "1 goal" , And so on;

• A positive number means the home team's handicap, a negative number means the away team's handicap.

• 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: Interwette 22: 10BET 23: 188bet 24: 12bet 31: Sbobet 35: Wewbet 42: 18bet 47: Pinnacle 48: HK Jockey Club

• “Whether Closed”only supports some companies:
1: Macauslot 3: Crown 8: Bet365 12: Easybets 17: Mansion88 22: 10BET 23: 188bet 24: 12bet 31: Sbobet 35: Wewbet 42: 18bet 47: Pinnacle

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 second/call;
  • Recommend Calls: 10 minute/call
  • Parameters:
ParameterValueRequiredDescription
datestringfalseGet the match data of the specified date, the range is from GMT +0 0:00-23:59;
Support one month of back-checking.

yyyy-MM-dd, e.g. date=2019-08-01.
matchIdstringfalseGet the data for the specified match.
When multiple matches are acquired at the same time, use "," to separate the matchId.

e.g. matchId=322964610,322964611.
Get a maximum of 100 at a time.
companyIdstringfalseGet the data for the specified company.
When multiple companies are acquired at the same time, use "," to separate the companyId.

e.g. companyId=3,8.

Response

  • The prefix "initial" means the first one that won't be changed. As for historical odds, the prefix "instant" means the last one before the match.
ParameterValueDescription
handicap string arrayEach string contains all parameters below, separated by comma.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwette
22: 10BET
23: 188bet
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
47: Pinnacle
48: HK Jockey Club
initialHandicap string1 means home team score minus 1.
-1 means home team score add 1.
1.25 means 1/1.5.
initialHome string
initialAway string
instantHandicap string1 means home team score minus 1.
-1 means home team score add 1.
1.25 means 1/1.5.
instantHome string
instantAway string
maintenance booleanThe bet may be closed temporarily when the system is being maintained.
inPlay booleanIs it inplay odds?
changeTime intChange time, unix timestamp
close booleanIs this bet closed?
europeOdds string array Known as 1x2 odds. Each string contains all parameters below, separated by comma.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwette
22: 10BET
23: 188bet
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
47: Pinnacle
48: HK Jockey Club
initialHome string
initialDraw string
initialAway string
instantHome string
instantDraw string
instantAway string
changeTime intChange time, unix timestamp
close booleanIs this bet closed?
overUnder string array Each string contains all parameters below, separated by comma.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwette
22: 10BET
23: 188bet
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
47: Pinnacle
48: HK Jockey Club
initialHandicap string1 means the total number of goals is 1.
1.25 means 1/1.5.
initialOver string
initialUnder string
instantHandicap string1 means the total number of goals is 1.
1.25 means 1/1.5.
instantOver string
instantUnder string
changeTime intChange time, unix timestamp
close booleanIs this bet closed?
handicapHalf string array Each string contains all parameters below, separated by comma.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwette
22: 10BET
23: 188bet
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
47: Pinnacle
48: HK Jockey Club
initialHandicap string1 means home team score minus 1.
-1 means home team score add 1.
1.25 means 1/1.5.
initialHome string
initialAway string
instantHandicap string1 means home team score minus 1.
-1 means home team score add 1.
1.25 means 1/1.5.
instantHome string
instantAway string
changeTime intChange time, unix timestamp
overUnderHalf string array Each string contains all parameters below, separated by comma.
matchId string
companyId string1: Macauslot
3: Crown
4: Ladbrokes
7: SNAI
8: Bet365
9: William Hill
12: Easybets
14: Vcbet
17: Mansion88
19: Interwette
22: 10BET
23: 188bet
24: 12bet
31: Sbobet
35: Wewbet
42: 18bet
47: Pinnacle
48: HK Jockey Club
initialHandicap string1 means the total number of goals is 1.
1.25 means 1/1.5.
initialOver string
initialUnder string
instantHandicap string1 means the total number of goals is 1.
1.25 means 1/1.5.
instantOver string
instantUnder string
changeTime intChange time, unix timestamp

Example Request

Example Response

{}
    • This API endpoint returns the historical initial and final odds data of the main market of the match. \n\n • By default, it returns the match data from GMT+0 0:00 to the currently completed match.\n\n • Data includes: handicap、handicapHalf、europeOdds、overUnder and overUnderHalf.\n\n • Handicap and overUnder description:\n -Handicap is an integer multiple of 0.25, 0 means "0 goal", 0.25 means "0/0.5 goal", 0.5 means "0.5 goal", 0.75 means "0.5/1 goal", 1 means "1 goal" , And so on;\n\n • A positive number means the home team's handicap, a negative number means the away team's handicap.\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: Interwette 22: 10BET 23: 188bet 24: 12bet 31: Sbobet 35: Wewbet 42: 18bet 47: Pinnacle 48: HK Jockey Club\n\n • “Whether Closed”only supports some companies:\n 1: Macauslot 3: Crown 8: Bet365 12: Easybets 17: Mansion88 22: 10BET 23: 188bet 24: 12bet 31: Sbobet 35: Wewbet 42: 18bet 47: Pinnacle

    Historical Odds (Main)iSportsAPI

    Contact