賠率

主客和、讓球及入球大細，另有馬會球會盤口、角球與波膽、賠率走勢、凱利指數及交易所數據。

本頁內容

賽事賠率

GET/v1/football/matches/{matchId}/odds

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 26

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
lastUpdatedUtc	datetime可能省略	該場比賽任何賠率最後變動的時間。
matchResult	HadQuoteDto[]	主客和（主勝／和局／客勝）。
└bookmaker	string可能省略	博彩公司名稱，末尾可能帶星號。請以 /odds/bookmakers 提供的數字識別碼建立網址。
└openHome	string可能省略	初始主勝賠率。
└openDraw	string可能省略	初始和局賠率。
└openAway	string可能省略	初始客勝賠率。
└closeHome	string可能省略	最新主勝賠率。
└closeDraw	string可能省略	最新和局賠率。
└closeAway	string可能省略	最新客勝賠率。
asianHandicap	HdpQuoteDto[]	亞洲讓球盤口及賠率。
└bookmaker	string可能省略	博彩公司名稱。
└openLine	string可能省略	初始讓球盤口，例如 -0.5 表示主隊讓半球。
└openHome	string可能省略	初始盤口的主隊賠率。
└openAway	string可能省略	初始盤口的客隊賠率。
└closeLine	string可能省略	最新讓球盤口。
└closeHome	string可能省略	最新主隊賠率。
└closeAway	string可能省略	最新客隊賠率。
overUnder	HiloQuoteDto[]	總入球大細盤口及賠率。
└bookmaker	string可能省略	博彩公司名稱。
└openLine	string可能省略	初始總入球盤口，例如 2.5。
└openOver	string可能省略	初始大球賠率。
└openUnder	string可能省略	初始細球賠率。
└closeLine	string可能省略	最新總入球盤口。
└closeOver	string可能省略	最新大球賠率。
└closeUnder	string可能省略	最新細球賠率。

回應狀態 200, 401, 403, 404, 429

前往試用

凱利指數

GET/v1/football/matches/{matchId}/odds/kelly

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 21

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
opening	KellyQuoteDto[]	每間公司的初始報價。
└bookmaker	string可能省略	博彩公司名稱。
└home	string可能省略	主隊賠率。
└draw	string可能省略	和局賠率。
└away	string可能省略	客隊賠率。
└kellyHome	string可能省略	主勝的凱利指數，用於比較市場報價；並非投注金額或勝出機率。
└kellyDraw	string可能省略	和局的凱利指數。
└kellyAway	string可能省略	客勝的凱利指數。
└payout	string可能省略	此組報價的公司返還率。
└recordedUtc	datetime可能省略	記錄此報價的時間。
closing	KellyQuoteDto[]	每間公司的最新報價。
└bookmaker	string可能省略	博彩公司名稱。
└home	string可能省略	主隊賠率。
└draw	string可能省略	和局賠率。
└away	string可能省略	客隊賠率。
└kellyHome	string可能省略	主勝的凱利指數，用於比較市場報價；並非投注金額或勝出機率。
└kellyDraw	string可能省略	和局的凱利指數。
└kellyAway	string可能省略	客勝的凱利指數。
└payout	string可能省略	此組報價的公司返還率。
└recordedUtc	datetime可能省略	記錄此報價的時間。

回應狀態 200, 401, 403, 404, 429

前往試用

香港賽馬會賠率

GET/v1/football/matches/{matchId}/odds/hkjc

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

馬會盤口範圍

提供 18 組全場及半場盤口的賠率紀錄，包括球會入球大細、球會角球大細、半場球會入球大細、半場球會角球大細、波膽及半場波膽。

查看盤口範例（不扣 API 配額）

球會盤口與波膽欄位

盤口	欄位	彩池代碼
球會入球大細	teamOverUnder	HLH / HLA
球會角球大細	teamCornersOverUnder	CHH / CHA
半場球會入球大細	firstHalfTeamOverUnder	FLH / FLA
半場球會角球大細	firstHalfTeamCornersOverUnder	CFH / CFA
波膽	correctScore	CRS
半場波膽	firstHalfCorrectScore	FCS

球會盤口的 poolType 識別主客隊：HLH、CHH、FLH、CFH 為主隊；HLA、CHA、FLA、CFA 為客隊。同一球會及時間可有多條大細盤口。

波膽的 scoreOdds 保留原始投注選項代碼、賠率、狀態及巢狀資料；其中的 name_en、name_ch、line_status 等欄位保留 snake_case 名稱。選項可包括 HO、OAN 等特別結果，不能一律當作數字比分；未提供或暫停的賠率不代表零。

各組紀錄由舊至新排列；以 recordedUtc 判斷資料時間。馬會沒有提供的盤口回傳空陣列，整張賠率表尚未提供時可回傳 404。

賠率表預設快取 60 秒，HTTP 回應亦可私人快取 60 秒。建議每分鐘最多查詢一次；快取命中的 API 請求仍會扣除配額。recordedUtc 是賠率觀察時間，並非請求時間。

請求範例

請先填寫必填參數：matchId

回應欄位 · 106

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
matchResult	HkjcMatchResultRowDto[]	全場主客和的不同選項。
└home	string可能省略	主隊賠率。
└draw	string可能省略	和局賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
handicap	HkjcHandicapRowDto[]	全場亞洲讓球變化。
└homeLine	string可能省略	主隊盤口，例如 -1。
└awayLine	string可能省略	客隊盤口，例如 +1。
└home	string可能省略	主隊賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
overUnder	HkjcOverUnderRowDto[]	全場總入球的不同選項。
└line	string可能省略	入球或角球的盤口。
└over	string可能省略	大球賠率。
└under	string可能省略	細球賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
firstHalfMatchResult	HkjcMatchResultRowDto[]	上半場主客和的不同選項。
└home	string可能省略	主隊賠率。
└draw	string可能省略	和局賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
firstHalfOverUnder	HkjcOverUnderRowDto[]	上半場總入球的不同選項。
└line	string可能省略	入球或角球的盤口。
└over	string可能省略	大球賠率。
└under	string可能省略	細球賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
cornersOverUnder	HkjcOverUnderRowDto[]	全場角球大細變化。
└line	string可能省略	入球或角球的盤口。
└over	string可能省略	大球賠率。
└under	string可能省略	細球賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
handicapMatchResult	HkjcHandicapMatchResultRowDto[]可能省略	全場讓球主客和變化。
└homeLine	string可能省略	馬會主隊讓球盤口。
└awayLine	string可能省略	馬會客隊讓球盤口。
└home	string可能省略	主隊賠率。
└draw	string可能省略	和局賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
oddEven	HkjcOddEvenRowDto[]可能省略	全場入球單雙變化。
└odd	string可能省略	總入球單數賠率。
└even	string可能省略	總入球雙數賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
firstHalfHandicap	HkjcHandicapRowDto[]可能省略	半場亞洲讓球變化。
└homeLine	string可能省略	主隊盤口，例如 -1。
└awayLine	string可能省略	客隊盤口，例如 +1。
└home	string可能省略	主隊賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
firstHalfCornersOverUnder	HkjcOverUnderRowDto[]可能省略	半場角球大細變化。
└line	string可能省略	入球或角球的盤口。
└over	string可能省略	大球賠率。
└under	string可能省略	細球賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
cornersHandicap	HkjcHandicapRowDto[]可能省略	全場角球讓球變化。
└homeLine	string可能省略	主隊盤口，例如 -1。
└awayLine	string可能省略	客隊盤口，例如 +1。
└home	string可能省略	主隊賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
firstHalfCornersHandicap	HkjcHandicapRowDto[]可能省略	半場角球讓球變化。
└homeLine	string可能省略	主隊盤口，例如 -1。
└awayLine	string可能省略	客隊盤口，例如 +1。
└home	string可能省略	主隊賠率。
└away	string可能省略	客隊賠率。
└recordedUtc	datetime可能省略	賠率表顯示這些價格的時間。
teamOverUnder	HkjcTeamOverUnderRowDto[]可能省略	全場球會入球大細：HLH 為主隊，HLA 為客隊。
└poolType	string	原始馬會彩池：HLH/HLA（入球）、FLH/FLA（半場入球）、CHH/CHA（角球）、CFH/CFA（半場角球）。
└teamSide	string	HLH、FLH、CHH、CFH 對應 home（主隊）；HLA、FLA、CHA、CFA 對應 away（客隊）。
└line	string可能省略	球會大細盤口，已移除外圍括號。
└over	string可能省略	大盤賠率；字串保留來源報價精度。
└under	string可能省略	細盤賠率；字串保留來源報價精度。
└recordedUtc	datetime可能省略	觀察到此球會賠率的 UTC 時間。
firstHalfTeamOverUnder	HkjcTeamOverUnderRowDto[]可能省略	半場球會入球大細：FLH 為主隊，FLA 為客隊。
└poolType	string	原始馬會彩池：HLH/HLA（入球）、FLH/FLA（半場入球）、CHH/CHA（角球）、CFH/CFA（半場角球）。
└teamSide	string	HLH、FLH、CHH、CFH 對應 home（主隊）；HLA、FLA、CHA、CFA 對應 away（客隊）。
└line	string可能省略	球會大細盤口，已移除外圍括號。
└over	string可能省略	大盤賠率；字串保留來源報價精度。
└under	string可能省略	細盤賠率；字串保留來源報價精度。
└recordedUtc	datetime可能省略	觀察到此球會賠率的 UTC 時間。
teamCornersOverUnder	HkjcTeamOverUnderRowDto[]可能省略	全場球會角球大細：CHH 為主隊，CHA 為客隊。
└poolType	string	原始馬會彩池：HLH/HLA（入球）、FLH/FLA（半場入球）、CHH/CHA（角球）、CFH/CFA（半場角球）。
└teamSide	string	HLH、FLH、CHH、CFH 對應 home（主隊）；HLA、FLA、CHA、CFA 對應 away（客隊）。
└line	string可能省略	球會大細盤口，已移除外圍括號。
└over	string可能省略	大盤賠率；字串保留來源報價精度。
└under	string可能省略	細盤賠率；字串保留來源報價精度。
└recordedUtc	datetime可能省略	觀察到此球會賠率的 UTC 時間。
firstHalfTeamCornersOverUnder	HkjcTeamOverUnderRowDto[]可能省略	半場球會角球大細：CFH 為主隊，CFA 為客隊。
└poolType	string	原始馬會彩池：HLH/HLA（入球）、FLH/FLA（半場入球）、CHH/CHA（角球）、CFH/CFA（半場角球）。
└teamSide	string	HLH、FLH、CHH、CFH 對應 home（主隊）；HLA、FLA、CHA、CFA 對應 away（客隊）。
└line	string可能省略	球會大細盤口，已移除外圍括號。
└over	string可能省略	大盤賠率；字串保留來源報價精度。
└under	string可能省略	細盤賠率；字串保留來源報價精度。
└recordedUtc	datetime可能省略	觀察到此球會賠率的 UTC 時間。
correctScore	HkjcCorrectScoreRowDto[]可能省略	全場波膽（CRS）快照，包括特別結果及選項資料。
└poolType	string	原始馬會彩池：CRS（全場）或 FCS（半場）。
└poolId	string可能省略	馬會彩池識別碼，若來源有提供。
└poolStatus	string可能省略	原始彩池開放狀態，若來源有提供。
└scoreOdds	array	依來源排序的原始馬會投注選項物件。保留數字及命名結果（例如 HO/AO/DO）、null 或未提供的賠率、status、line_status、combination_id、name_en、name_ch 及巢狀 selections。原始物件內的欄位保留 snake_case 名稱，亦保留未知資料。
└recordedUtc	datetime可能省略	觀察到完整彩池快照的 UTC 時間。
firstHalfCorrectScore	HkjcCorrectScoreRowDto[]可能省略	半場波膽（FCS）快照，包括特別結果及選項資料。
└poolType	string	原始馬會彩池：CRS（全場）或 FCS（半場）。
└poolId	string可能省略	馬會彩池識別碼，若來源有提供。
└poolStatus	string可能省略	原始彩池開放狀態，若來源有提供。
└scoreOdds	array	依來源排序的原始馬會投注選項物件。保留數字及命名結果（例如 HO/AO/DO）、null 或未提供的賠率、status、line_status、combination_id、name_en、name_ch 及巢狀 selections。原始物件內的欄位保留 snake_case 名稱，亦保留未知資料。
└recordedUtc	datetime可能省略	觀察到完整彩池快照的 UTC 時間。

回應狀態 200, 401, 403, 404, 429, 503

前往試用

賠率變動紀錄

GET/v1/football/matches/{matchId}/odds/{market}/{bookmaker}

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值
marketstringpath必填
賠率市場：had = 主勝／和／客勝（1X2）；hdp = 亞洲讓球；hilo = 入球大細。
bookmakerstringpath必填
使用 /odds/bookmakers 的數字 ID，或賠率回應中的完整莊家名稱。特殊字元會自動編碼。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

回應欄位 · 19

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
matchId	integer	Tipsme 比賽識別碼。
market	integer	had（主客和）、hdp（讓球）或 hilo（大細）。
bookmaker	string	此走勢所屬的博彩公司。
opening	OddsPointDto可能省略	首次記錄的價格。
└recordedUtc	datetime可能省略	記錄此價格的時間。
└line	string可能省略	讓球或總數盤口（只適用於 hdp／hilo）。
└home	string可能省略	主隊賠率（had／hdp）。
└draw	string可能省略	和局賠率（只適用於 had）。
└away	string可能省略	客隊賠率（had／hdp）。
└over	string可能省略	大球賠率（只適用於 hilo）。
└under	string可能省略	細球賠率（只適用於 hilo）。
history	OddsPointDto[]	開盤後的每次記錄，按時間排列。
└recordedUtc	datetime可能省略	記錄此價格的時間。
└line	string可能省略	讓球或總數盤口（只適用於 hdp／hilo）。
└home	string可能省略	主隊賠率（had／hdp）。
└draw	string可能省略	和局賠率（只適用於 had）。
└away	string可能省略	客隊賠率（had／hdp）。
└over	string可能省略	大球賠率（只適用於 hilo）。
└under	string可能省略	細球賠率（只適用於 hilo）。

回應狀態 200, 400, 401, 403, 404, 429

前往試用

交易所賠率

GET/v1/football/matches/{matchId}/odds/exchange

參數

matchIdinteger (int32)path必填
從即時比分或賽程列表取得的 Tipsme 數字比賽 ID，適用於比賽詳情、賠率及分析；分析需要 Plus 或 Pro。在 API 參考尋找此數值

請求範例

請先填寫必填參數：matchId

這個端點按原樣傳回上游文件。它的結構會隨賽事賽制而不同，沒有固定的資料結構可供示範——對應欄位之前，請先看一次真實回應。

回應狀態 401, 403, 404, 429, 502

前往試用

莊家 ID

GET/v1/football/odds/bookmakers

請求範例

curl -H "Authorization: Bearer $TIPSME_API_KEY" \
  "https://api.tipsme.hk/v1/football/odds/bookmakers"

data 中每個項目包含 · 4

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
id	integer	固定的數字識別碼，可在 API 請求中使用。
name	string	來源提供的公司名稱，可能含中文字或星號。請使用公司列表中的數字識別碼查詢賠率走勢。
nameEn	string	英文顯示名稱。
isAggregate	boolean	true 表示最低／最高值的彙總列，並非真正的博彩公司。

回應狀態 200, 401, 403, 429

前往試用

由免費方案開始

一條 API 金鑰，每個帳戶每日 30 次請求，另加每日 50 次免費賽程列表請求。真實數據，毋須信用卡。

取得免費 API 金鑰收費

這頁有幫助嗎？

不太有

聯絡支援 →