新手教程 · 3 分钟上手

V球数据是什么?

一个专业的足球数据平台:把全球主流联赛的比赛数据、专业赔率与赛前分析报告聚合到一处。既能直接在网页查看,也能通过开放接口(API)供你的系统或 AI 智能体调用。

个人分析师竞彩爱好者AI 智能体 / 开发者

一、平台能给你什么

无需任何技术基础,打开网页就能用;需要对接时,再往下看智能体与 API 教程。

实时比赛数据

比分、阵容、技术统计、进球事件,覆盖全球主流联赛,比赛进行中实时更新。

专业赔率对比

欧赔 / 亚盘 / 大小球,18 家主流公司同一场比赛的赔率与变动轨迹一屏对比。

赛前分析报告

xG 预期进球、射门分布、历史交锋、近期状态,赛前自动生成结构化报告。

竞彩玩法数据

官方在售比赛与全部玩法(胜平负、让球、总进球、半全场、比分)赔率。

3D 直播回放

已覆盖比赛的 3D 还原与滚球工作台,比赛画面可视化回看。

开放 API

标准 HTTP 接口,注册即可获得专属 API Key,供个人系统与 AI 智能体实时调用。

二、让智能体用上 V球数据

复制下面这段提示词发给 AI,它就能自己发现接口、调用真实数据并生成分析。

最快接入:复制提示词给 AI

把以下提示词复制粘贴给你的 AI 智能体,即可完成对接。

复制后发送到 Codex、扣子、WorkBuddy、豆包、Zcode、DeepSeek 等支持联网或工具调用的智能体对话框即可。

正在检测 API Key...
请接入 V球数据平台获取真实足球数据。

平台地址:https://vfootball.cn/
API Key:你的_API_Key

接入步骤:
1. 先请求 GET https://vfootball.cn/api/open/schema,自发现可用端点、参数与 semantics 数据口径。
2. 后续请求统一使用请求头 X-API-Key: 你的_API_Key。
3. 只使用平台 API 返回的真实数据,明确标注数据来源与时间。
4. 数据缺失时明确说明「平台暂无此数据」,禁止编造。
5. 仅用于数据研究,不构成投注、购彩或投资建议。

接入完成后回复「已接入 V球数据平台」,并告诉我你能查询哪些类型的数据。

更多场景提示词(赛前分析、xG、赔率变动、必发指数、滚球监控等 12 条)请前往 提示词广场 →

进阶:在智能体平台可视化配置(以下平台均可对接)

Codex扣子WorkBuddy豆包Zcode智谱清言DeepSeek腾讯元器百度千帆 AppBuilderKimi
1

获取专属 API Key

注册并登录后,进入「账号中心」→ 阅读并同意《API 服务协议》→ 复制您的专属 API Key。每个账号一个,请妥善保管。

2

在智能体里配置数据工具

在 Codex、扣子、WorkBuddy、豆包、Zcode、DeepSeek 等智能体平台中新建 HTTP 工具(或 Function Calling),填入接口地址,并把请求头 X-API-Key 设为你的 Key。

3

让智能体调用数据生成分析

在对话里让智能体查数据,例如:“查一下 600981 这场比赛的详情和赔率,帮我写一份赛前分析”。智能体会自动调用接口并组织成回答。

扣子工具配置示例(其他平台配置类似,可视化填写即可)

HTTP 工具定义
名称:查询比赛详情
描述:查询 V球数据指定比赛的详情,含比分、场地、天气、裁判等
URL:https://vfootball.cn/api/open/matches/detail
方法:GET
请求头:X-API-Key = 你的 API Key
参数:match_id = 600981(比赛 ID)

推荐组合:比赛详情 matches/detail + 赔率 matches/odds + 历史交锋 matches/h2h + 球队赛程 teams/fixtures,可覆盖绝大多数分析场景。

三、直接调用 API(开发者)

所有接口使用同一套鉴权:在请求头携带 X-API-Key。下面的示例可直接复制运行。

curl
curl -H "X-API-Key: 你的 API Key" \
  "https://vfootball.cn/api/open/matches/detail?match_id=600981"
Python
import requests

resp = requests.get(
    "https://vfootball.cn/api/open/matches/detail",
    params={"match_id": 600981},
    headers={"X-API-Key": "你的 API Key"},
)
print(resp.json())
Node.js
const res = await fetch(
  "https://vfootball.cn/api/open/matches/detail?match_id=600981",
  { headers: { "X-API-Key": "你的 API Key" } }
);
console.log(await res.json());
常用接口速查
/api/open/matches比赛列表(按日期 / 联赛筛选,含实时比分)
/api/open/matches/detail比赛详情(含场地、天气、裁判)
/api/open/matches/odds比赛赔率(欧赔 / 亚盘 / 大小球)
/api/open/matches/h2h历史交锋
/api/open/teams/fixtures球队近期赛程

使用注意事项

  • 数据访问窗口按套餐分级:试用 24 小时 / 包月 30 天 / 包季 90 天 / 包年 365 天; 包月及以上套餐调用比赛列表接口时,不传日期即可返回近 30 天的比赛(配合offset 分页可拉取全量)。
  • 接口有频率限制,请勿高频轮询;触发限制时返回 429。
  • 首次使用需在「账号中心」同意《API 服务协议》。
  • 完整接口列表与字段说明见 API 文档。

四、常见问题

没有技术背景能用吗?

能。网页端打开即用,无需任何技术;智能体对接在 Codex、扣子、WorkBuddy、豆包、Zcode、DeepSeek 等平台用可视化配置即可完成。

API Key 在哪里找?

登录后进入「账号中心」→ API Key(需先同意 API 服务协议)。Key 有有效期,到期前可留意账号中心提示。

数据多久更新一次?

比赛数据实时更新,赔率持续刷新,无需手动同步。

平台收费吗?

免费注册即可使用基础功能;进阶版(完整数据与能力)通过激活码开通,详见「定价」页。