賠率
主客和、讓球及入球大細賠率、賠率走勢、凱利指數、馬會及交易所數據。
本頁內容
賽事賠率
/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
凱利指數
/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
香港賽馬會賠率
/v1/football/matches/{matchId}/odds/hkjc參數
matchIdinteger (int32)path必填從即時比分或賽程列表取得的 Tipsme 數字比賽 ID,適用於比賽詳情、賠率及分析;分析需要 Plus 或 Pro。 在 API 參考尋找此數值
請求範例
請先填寫必填參數:matchId
回應欄位 · 32
選填欄位可能不會出現。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可能省略 | 賠率表顯示這些價格的時間。 |
回應狀態 200, 401, 403, 404, 429
賠率變動紀錄
/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
交易所賠率
/v1/football/matches/{matchId}/odds/exchange參數
matchIdinteger (int32)path必填從即時比分或賽程列表取得的 Tipsme 數字比賽 ID,適用於比賽詳情、賠率及分析;分析需要 Plus 或 Pro。 在 API 參考尋找此數值
請求範例
請先填寫必填參數:matchId
這個端點按原樣傳回上游文件。它的結構會隨賽事賽制而不同,沒有固定的資料結構可供示範——對應欄位之前,請先看一次真實回應。
回應狀態 401, 403, 404, 429, 502
莊家 ID
/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 次免費賽程列表請求。真實數據,毋須信用卡。