GoalXData
登录
今日数据联赛数据策略中心数据接口会员方案
GOALXDATA API

FOOTBALL API · V1

生产级足球数据 API

统一公共 ID、标准中文、明确的模块生命周期和可审计的新鲜度。 内部来源、存储结构与采集层不会进入客户响应。

领取三天免费试用 查看机器合同
00

三天免费试用

邮箱注册后自助申请：连续 72 小时；普通 REST 与赔率 REST 各有每小时 4,000 次独立额度。

先验证邮箱，再领取试用 Key

邮箱验证码登录成功后即可填写申请。每个邮箱只能领取一次。

邮箱注册 / 登录
01客户只使用 gxc_ / gxs_ / gxt_ / gxp_ / gxf_ 公共 ID。
02中文名称来自 GoalXData 标准实体档案，不透传采集文本。
03每个模块返回可用性、完整性与新鲜度；缺失不推算、不补零。
04未来赛程修正保持同一 gxf_，客户用 updatedSince 增量接收。
01

产品与权限

每个产品都有独立 scope、交付方式和上线状态。

产品状态交付Scope合同
高级详情包已开放RESTfootball:advanced-detail每个赛事当前有效赛季；35 个比赛模块按实际有值和生命周期交付。
高级赛前赔率正式商业版REST + WebSocketfootball:advanced-prematch-odds独立附加包；当前赔率可每 2 秒读取并包含赛前 WebSocket。18 家公司为产品覆盖口径，逐场可能不齐全。
滚球赔率正式商业版REST + WebSocketfootball:inplay-odds独立附加包、独立权限；支持每 2 秒读取和实时推送，与其他赔率 REST 共用赔率独立额度池。
历史赔率附加包已开放RESTfootball:history:odds只返回全场进球数、让球盘、胜平负的出盘与临场；不含中间变化，不合成缺失值。
历史数据附加包已开放RESTfootball:history:data授权读取 2005 年起实际可用的赛事、赛季和比赛详情；不包含其他赔率产品。
02

接口目录

足球基础路径 https://goalxdata.com/api/v1/football；WebSocket 票据使用 /api/v1/realtime/ticket

目录

取得公共 ID 与基础实体。

GET
/capabilities

能力与产品状态

GET
/competitions

赛事目录

GET
/competitions/{gxc_id}

赛事详情

GET
/seasons

赛季目录

GET
/seasons/{gxs_id}

赛季详情

GET
/teams

球队目录

GET
/teams/{gxt_id}

球队详情

GET
/players

球员目录

GET
/players/{gxp_id}

球员详情

比赛与详情

一个 gxf_ 贯穿赛前、赛中和赛后。

GET
/matches

当前赛季比赛与赛程修正

GET
/matches/{gxf_id}

单场聚合详情

GET
/matches/{gxf_id}/modules

35 个模块可用性

GET
/matches/{gxf_id}/modules/{module}

指定比赛模块

GET
/matches/{gxf_id}/post-match-news

标准中文赛后新闻

GET
/standings

积分榜

GET
/squads

阵容目录

GET
/team-season-metrics

球队赛季指标

GET
/player-season-metrics

球员赛季指标

赔率

赛前高级赔率与赛中滚球赔率独立授权，均经过配对与新鲜度门禁。

GET
/pregame-index

全部可用公司简称、市场、指数和赔率

GET
/matches/{gxf_id}/pre-match-index

单场当前高级赔率

GET
/matches/{gxf_id}/pre-match-index/opening-closing

历史赔率出盘与临场（独立权限）

GET
/matches/{gxf_id}/pre-match-index/history

旧 Key 历史兼容接口（已弃用）

GET
/matches/{gxf_id}/in-play-index

单场滚球赔率（独立权限）

POST
/api/v1/realtime/ticket

赔率 WebSocket 正式商业版票据

历史

需要历史数据附加包；缺值不补零。

GET
/history/matches

历史比赛

GET
/history/matches/{gxf_id}

历史单场详情

GET
/history/matches/{gxf_id}/modules

历史模块目录

GET
/history/matches/{gxf_id}/modules/{module}

历史指定模块

GET
/history/team-season-metrics

历史球队指标

GET
/history/player-season-metrics

历史球员指标

03

开始接入

所有请求使用 Bearer 或 X-API-Key。

  • 固定 JSON 信封与 requestId
  • 每个 Key：普通 REST 全局 4,000 次/小时，赔率 REST 独立 4,000 次/小时
  • 两个额度池均不设每秒限制；每个 HTTP 请求只计 1 次
  • 高级赔率只返回已配对、已复核且新鲜的数据
  • 赛前当前赔率和已授权滚球赔率均支持每 2 秒轮询
  • 历史赔率只提供三个全场市场的出盘与临场
  • WebSocket 正式商业版推送消息不占 REST 额度
  • 所有 API 时间统一为北京时间（UTC+08:00）
FIRST REQUEST
curl --fail-with-body \
  'https://goalxdata.com/api/v1/football/matches?limit=50' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <API_KEY>'
技术总览接口手册
GoalXData Football API | GoalXData