即時比分

即時比分及單場比賽狀態，附開賽時間與主客隊標誌。

本頁內容

即時賽事

GET/v1/football/matches/live

參數

leaguestringquery選填
使用賽事 competition.name 或 nameOriginal 中的完整名稱，不分大小寫。留空表示全部賽事。例如： Premier League 在 API 參考尋找此數值
statusstringquery選填
按未開賽、進行中、已完場、延期或取消篩選。留空表示所有狀態。例如： live

請求範例

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

data 中每個項目包含 · 34

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

欄位	類型	說明
id	integer	Tipsme 比賽識別碼，可用於所有 /matches/{matchId}/… 端點。
kickoffUtc	datetime	預定開賽時間，採用 ISO-8601 UTC。
competition	CompetitionRef	賽事名稱。
└name	string可能省略	所請求語言的賽事名稱。
└nameOriginal	string可能省略	來源公佈的賽事名稱。
home	TeamRef	主隊。
└name	string可能省略	Accept-Language 指定語言的球隊名稱；無翻譯時使用原名。
└nameOriginal	string可能省略	資料來源公佈的球隊名稱。
└ranking	string可能省略	開賽時的聯賽排名（如已知）。
away	TeamRef	客隊。
└name	string可能省略	Accept-Language 指定語言的球隊名稱；無翻譯時使用原名。
└nameOriginal	string可能省略	資料來源公佈的球隊名稱。
└ranking	string可能省略	開賽時的聯賽排名（如已知）。
status	integer	scheduled（未開賽）、live（進行中）、finished（完場）、postponed（延期）或 cancelled（取消）；代碼不隨語言改變。
minute	string可能省略	即時比賽分鐘，例如 63 或 45+2。
additionalTime	string可能省略	本半場公佈的補時分鐘數。
score	ScoreDto可能省略	各階段比分；開賽前未有資料時會省略。
└current	string可能省略	目前或完場比分，格式為「主隊-客隊」。
└halfTime	string可能省略	半場比分。
└extraTime	string可能省略	加時賽後的比分（如有加時）。
└penalty	string可能省略	互射十二碼比分（如有進行）。
homeCards	CardCount可能省略	主隊獲出示的牌數。
└yellow	integer可能省略	此方獲出示的黃牌數。
└red	integer可能省略	此方獲出示的紅牌數。
awayCards	CardCount可能省略	客隊獲出示的牌數。
└yellow	integer可能省略	此方獲出示的黃牌數。
└red	integer可能省略	此方獲出示的紅牌數。
corners	string可能省略	角球數，格式為「主隊-客隊」。
isNeutralVenue	boolean	true 表示在中立場地作賽。
isCup	boolean	true 表示盃賽。
isBracket	boolean	true 表示此賽程屬於淘汰賽。
isHkjc	boolean	true 表示香港賽馬會提供此賽事；只有此類比賽可能提供馬會賠率。
homeLogo	string可能省略	由主隊原始名稱組成的 assets.tipsme.hk PNG 隊徽網址。原始名稱缺失時省略；圖片可能不存在。
awayLogo	string可能省略	由客隊原始名稱組成的 assets.tipsme.hk PNG 隊徽網址。原始名稱缺失時省略；圖片可能不存在。

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

前往試用

賽事詳情

GET/v1/football/matches/{matchId}

參數

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

請求範例

請先填寫必填參數：matchId

回應欄位 · 34

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

欄位	類型	說明
id	integer	Tipsme 比賽識別碼，可用於所有 /matches/{matchId}/… 端點。
kickoffUtc	datetime	預定開賽時間，採用 ISO-8601 UTC。
competition	CompetitionRef	賽事名稱。
└name	string可能省略	所請求語言的賽事名稱。
└nameOriginal	string可能省略	來源公佈的賽事名稱。
home	TeamRef	主隊。
└name	string可能省略	Accept-Language 指定語言的球隊名稱；無翻譯時使用原名。
└nameOriginal	string可能省略	資料來源公佈的球隊名稱。
└ranking	string可能省略	開賽時的聯賽排名（如已知）。
away	TeamRef	客隊。
└name	string可能省略	Accept-Language 指定語言的球隊名稱；無翻譯時使用原名。
└nameOriginal	string可能省略	資料來源公佈的球隊名稱。
└ranking	string可能省略	開賽時的聯賽排名（如已知）。
status	integer	scheduled（未開賽）、live（進行中）、finished（完場）、postponed（延期）或 cancelled（取消）；代碼不隨語言改變。
minute	string可能省略	即時比賽分鐘，例如 63 或 45+2。
additionalTime	string可能省略	本半場公佈的補時分鐘數。
score	ScoreDto可能省略	各階段比分；開賽前未有資料時會省略。
└current	string可能省略	目前或完場比分，格式為「主隊-客隊」。
└halfTime	string可能省略	半場比分。
└extraTime	string可能省略	加時賽後的比分（如有加時）。
└penalty	string可能省略	互射十二碼比分（如有進行）。
homeCards	CardCount可能省略	主隊獲出示的牌數。
└yellow	integer可能省略	此方獲出示的黃牌數。
└red	integer可能省略	此方獲出示的紅牌數。
awayCards	CardCount可能省略	客隊獲出示的牌數。
└yellow	integer可能省略	此方獲出示的黃牌數。
└red	integer可能省略	此方獲出示的紅牌數。
corners	string可能省略	角球數，格式為「主隊-客隊」。
isNeutralVenue	boolean	true 表示在中立場地作賽。
isCup	boolean	true 表示盃賽。
isBracket	boolean	true 表示此賽程屬於淘汰賽。
isHkjc	boolean	true 表示香港賽馬會提供此賽事；只有此類比賽可能提供馬會賠率。
homeLogo	string可能省略	由主隊原始名稱組成的 assets.tipsme.hk PNG 隊徽網址。原始名稱缺失時省略；圖片可能不存在。
awayLogo	string可能省略	由客隊原始名稱組成的 assets.tipsme.hk PNG 隊徽網址。原始名稱缺失時省略；圖片可能不存在。

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

前往試用

由免費方案開始

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

取得免費 API 金鑰收費

這頁有幫助嗎？

不太有

聯絡支援 →