实时比分

实时比分及单场比赛状态，附开赛时间与主客队标志。

本页内容

实时赛事

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 密钥价格

这页有帮助吗？

不太有

联系支持 →