Odd Modify Record

Update Time: 2026-06-27 15:53

Introduction

• This API endpoint returns historical odds for matches whose odds changed within a specific time window, supporting three query modes:

1.type=match — Returns a list of matches with historical odds that may have increased or decreased in the last hour, along with the bookmaker that changed and the operation time.

2.matchId + companyId — Returns historical odds for a specific match and bookmaker, main market only (e.g., /sport/football/odds/oddsbyid?api_key&matchId=256921227&companyId=3).

3.type=multi + matchId + companyId — Returns historical odds for a specific match and bookmaker, all markets (e.g., /sport/football/odds/oddsbyid?api_key&type=multi&matchId=256921227&companyId=3).

• In-play odds history is available for the past month. Opening and latest pre-match odds are available for up to one year.

Related Plans

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

Request

  • Path: /sport/football/odds/oddsbyid
  • Method: GET
  • Calls: This interface is limited to 10 seconds/call;
  • Recommend Calls: 20 seconds/call
  • Parameters:
ParameterValueRequiredDescription
type=matchstring trueReturns a list of matches with historical odds that may have changed in the last hour.
matchId + companyIdstring trueReturns historical odds for the specified match and bookmaker (main market only).
type=multi + matchId + companyIdstring trueReturns historical odds for the specified match and bookmaker (all markets).

Response

ParameterValueDescription
list listReturned only when type=match is used.
matchId string
companyId stringBookmaker ID that changed odds for this match. 0 means all odds for this match have been cleared.
operateTime int Timestamp of this odds change (Unix timestamp, GMT+0)
handicap string arrayAsian Handicap odds
companyID string Bookmaker ID
num intLine sequence number. Multi-market interface only — not present when querying the main-market interface.
odds1 stringOpening handicap line
odds2 stringOpening Asian Handicap odds — home side
odds3 stringOpening Asian Handicap odds — away side
odds4 stringCurrent handicap line
odds5 stringCurrent Asian Handicap odds — home side
odds6 stringCurrent Asian Handicap odds — away side
modifyTime int Timestamp of the last odds update (Unix timestamp, GMT+0)
detail objectFull change history for this line
id string Unique record ID
odds1 stringHandicap line at this point in time
odds2 stringHome side odds at this point in time
odds3 stringAway side odds at this point in time
modifyTime int Timestamp of this change (Unix timestamp, GMT+0)
type smallintMulti-market interface only.
1: Early odds
2: Pre-match closing odds (after early odds, before kick-off)
3: In-play odds
isEarly booleanMain-market interface only.

true: Early odds
false: Not early odds
overUnder string arrayOver/under odds
companyID string Bookmaker ID
num intLine sequence number. Multi-market interface only — not present when querying the main-market interface.
odds1 stringOpening over/under line
odds2 stringOpening over odds
odds3 stringOpening under odds
odds4 stringCurrent over/under line
odds5 stringCurrent over odds
odds6 stringCurrent under odds
modifyTime int Timestamp of the last odds update (Unix timestamp, GMT+0)
detail object Full change history for this line
id string Unique record ID
odds1 stringOver/under line at this point in time
odds2 stringOver odds at this point in time
odds3 stringUnder odds at this point in time
modifyTime int Timestamp of this change (Unix timestamp, GMT+0)
type smallintMulti-market interface only. Same values as handicap detail.type.
isEarly booleanMain-market interface only. Same values as handicap detail.isEarly.
europe string array 1X2 odds
companyID string Bookmaker ID
odds1 stringOpening 1X2 odds — home win
odds2 stringOpening 1X2 odds — draw
odds3 stringOpening 1X2 odds — away win
odds4 stringCurrent 1X2 odds — home win
odds5 stringCurrent 1X2 odds — draw
odds6 stringCurrent 1X2 odds — away win
modifyTime int Timestamp of the last odds update (Unix timestamp, GMT+0)
detail object Full change history
id string Unique record ID
odds1 stringHome win odds at this point in time
odds2 stringDraw odds at this point in time
odds3 stringAway win odds at this point in time
modifyTime int Timestamp of this change (Unix timestamp, GMT+0)
isEarly booleantrue: Early odds
false: Not early odds
halfHandicap string array First-half Asian Handicap odds
companyID string Bookmaker ID
num intLine sequence number. Multi-market interface only — not present when querying the main-market interface.
odds1 string Opening first-half handicap line
odds2 string Opening first-half Asian Handicap odds — home side
odds3 string Opening first-half Asian Handicap odds — away side
odds4 string Current first-half handicap line
odds5 string Current first-half Asian Handicap odds — home side
odds6 string Current first-half Asian Handicap odds — away side
modifyTime int Timestamp of the last odds update (Unix timestamp, GMT+0)
detail object Full change history for this line
id string Unique record ID
odds1 string Handicap line at this point in time
odds2 string Home side odds at this point in time
odds3 string Away side odds at this point in time
modifyTime int Timestamp of this change (Unix timestamp, GMT+0)
type smallintMulti-market interface only. Same values as handicap detail.type.
isEarly booleanMain-market interface only. Same values as handicap detail.isEarly.
halfOverUnder string array First-half over/under odds
companyID string Bookmaker ID
num intLine sequence number. Multi-market interface only — not present when querying the main-market interface.
odds1 stringOpening first-half over/under line
odds2 stringOpening first-half over odds
odds3 stringOpening first-half under odds
odds4 stringCurrent first-half over/under line
odds5 stringCurrent first-half over odds
odds6 stringCurrent first-half under odds
modifyTime int Timestamp of the last odds update (Unix timestamp, GMT+0)
detail object Full change history for this line
id string Unique record ID
odds1 stringOver/under line at this point in time
odds2 stringOver odds at this point in time
odds3 stringUnder odds at this point in time
modifyTime int Timestamp of this change (Unix timestamp, GMT+0)
type smallintMulti-market interface only. Same values as handicap detail.type.
isEarly booleanMain-market interface only. Same values as handicap detail.isEarly.
halfEurope string array First-half 1X2 odds
companyID string Bookmaker ID
odds1 string Opening first-half 1X2 odds — home win
odds2 string Opening first-half 1X2 odds — draw
odds3 string Opening first-half 1X2 odds — away win
odds4 string Current first-half 1X2 odds — home win
odds5 string Current first-half 1X2 odds — draw
odds6 string Current first-half 1X2 odds — away win
modifyTime intTimestamp of the last odds update (Unix timestamp, GMT+0)
detail object Full change history
id string Unique record ID
odds1 string Home win odds at this point in time
odds2 string Draw odds at this point in time
odds3 string Away win odds at this point in time
modifyTime int Timestamp of this change (Unix timestamp, GMT+0)
isEarly booleantrue: Early odds
false: Not early odds

Example Request

Example Response

    • This API endpoint returns historical odds for matches whose odds changed within a specific time window, supporting three query modes:\n\n
 1.type=match — Returns a list of matches with historical odds that may have increased or decreased in the last hour, along with the bookmaker that changed and the operation time.\n\n

 2.matchId + companyId — Returns historical odds for a specific match and bookmaker, main market only (e.g., /sport/football/odds/oddsbyid?api_key&matchId=256921227&companyId=3).\n\n

 3.type=multi + matchId + companyId — Returns historical odds for a specific match and bookmaker, all markets (e.g., /sport/football/odds/oddsbyid?api_key&type=multi&matchId=256921227&companyId=3).\n\n

• In-play odds history is available for the past month. Opening and latest pre-match odds are available for up to one year.
    Contact
    Contact
    BLOG
    Belgium expose USA errors to end co-hosts' World Cup runRonaldo's final World Cup ends in tears as Portugal exit and Martinez quitsSpain's historic defence is driving their World Cup push
    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.