快速上手
大约五分钟就能从 API 获取实时足球比分。选一条适合你的路径。
本页内容
1创建 API 密钥
登录后创建密钥。请立即复制。完整密钥只会显示一次。
取得免费密钥2发送第一个请求
把 REPLACE_WITH_YOUR_KEY 换成你的密钥。把两行命令粘贴到终端，按 Enter。
export TIPSME_API_KEY="REPLACE_WITH_YOUR_KEY"
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/live"也可直接在浏览器试用。 打开试玩区
Windows 及其他语言
$env:TIPSME_API_KEY = "REPLACE_WITH_YOUR_KEY"
curl.exe -H "Authorization: Bearer $env:TIPSME_API_KEY" "https://api.tipsme.hk/v1/football/matches/live"请勿把金钥写入原始码或公开截图。此变数只适用于目前的终端机工作阶段。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/live"Python · 设定与执行
需要 Python 3 及 requests 套件。先执行下方安装指令，再把 Python 请求存为 tipsme.py 并在同一终端机执行。若系统使用 python3，请在所有指令中使用 python3。
python -m pip install requests
# Save the request as tipsme.py, then:
python tipsme.pyJavaScript · 设定与执行
需要 Node.js 18 或更新版本。把 JavaScript 请求存为 tipsme.mjs，再执行 node tipsme.mjs。此范例在 Node.js 中运行，透过 process.env 读取金钥。
// Save the request as tipsme.mjs, then run in a terminal:
// node tipsme.mjsC# · 设定与执行
需要 .NET 8 SDK 或更新版本。按下方指令建立主控台专案，以 C# 请求取代 Program.cs，再执行。毋须额外套件。
dotnet new console -o TipsmeExample
cd TipsmeExample
# Replace Program.cs with the C# request, then:
dotnet run3阅读响应
比赛位于 data 内。每场比赛的 id 可用于详情及赔率；Plus 和 Pro 也可查询分析。球队原始名称可用时，homeLogo 和 awayLogo 会提供图片网址。以下为示例。
{
"data": [
{
"id": 98224,
"kickoffUtc": "2026-09-08T12:00:00Z",
"competition": {
"name": "英格兰超级联赛",
"nameOriginal": "English Premier League"
},
"home": {
"name": "阿森纳",
"nameOriginal": "阿仙奴",
"ranking": "3"
},
"away": {
"name": "切尔西",
"nameOriginal": "車路士",
"ranking": "5"
},
"homeLogo": "https://assets.tipsme.hk/UploadFolder/Teams/%E9%98%BF%E4%BB%99%E5%A5%B4.png",
"awayLogo": "https://assets.tipsme.hk/UploadFolder/Teams/%E8%BB%8A%E8%B7%AF%E5%A3%AB.png",
"status": "live",
"minute": "63",
"score": {
"current": "2-1",
"halfTime": "1-0"
},
"homeCards": {
"yellow": 1,
"red": 0
},
"awayCards": {
"yellow": 2,
"red": 0
},
"corners": "4-3",
"isNeutralVenue": false,
"isCup": false,
"isBracket": false,
"isHkjc": true
}
]
}data 是空的，代表现在没有进行中的赛事。改用赛程端点查看即将开赛的赛事。
请求失败时，请查看错误代码说明。 错误码
4常见用法
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches?date=2026-10-02&tz=480"tz 是以分钟表示的 UTC 时差：480 代表香港（UTC+8），用于决定日期筛选所采用的日历日。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/98224/odds/hdp/2"盘口有三种：had（主客和）、hdp（让球）、hilo（大细）。2 是公司 id，完整列表在 /odds/bookmakers。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/matches/98224/analysis/ai-basic"使用 Plus 或 Pro 密钥，以及从赛程取得的比赛 ID。报告尚未发布时返回 404。
curl -H "Authorization: Bearer $TIPSME_API_KEY" \
"https://api.tipsme.hk/v1/football/meta/plans"公开方案资料不需要密钥，会列出各方案的分析权限及请求上限。
开始之前，你可能想知道
免费套餐够用吗？
测试用足够。免费方案每个账户每日 30 次请求，赛程列表另加每日 50 次。分析需要 Plus 或 Pro；两者的赛程列表额度分别为每日 500 次及 2000 次。
时间用哪个时区？
kickoffUtc 等时间都是 UTC。要按香港日期筛选赛程，请传 tz=480。每日额度在香港时间午夜重置。
响应是空的，是出错吗？
不是。200 加上 data: [] 代表没有符合的项目。404 代表该项目不存在，例如尚未公布的阵容。
费用会失控吗？
不会。超出额度的请求会被拒绝，不会额外收费。付费方案会自动续期。在账单页取消后，仍可用到期末。
密钥应该放在哪里？
放在你的服务器。不要放进网站或手机应用，任何人都能读到。你也可以把密钥限制在服务器的 IP 地址。
由免费方案开始
一个 API 密钥，每个账户每日 30 次请求，另加每日 50 次免费赛程列表请求。真实数据，无需信用卡。