⚽OpenData足球数据开放平台
中EN登录控制台免费试用 14 天

← 返回接口文档

GET/api/v1/matches/schedule/param

获取赛程赛果列表-维度查询
实时数据包activebetacore可调用(数据有范围)

接口说明

该接口返回维度查询对应的全量赛程赛果数据（赛事-最新赛季赛程、体彩-最近72h内彩种赛程）
请求次数：120次/min

调用信息

请求
GET https://api.sports.csap.ai/api/v1/matches/schedule/param
鉴权
请求头 X-API-Key: <你的 key>(也支持 Authorization: Bearer <key>;?key= 仍可用但不建议,key 会留在地址和日志里)
外部 key
可调用(数据有范围)外部 key 可以调用，但只返回开放范围内的数据，见「通用说明 · 外部 key 的数据范围」。
频率限制
每分钟 3000 次 · 每天 200000 次 · 按 key 配置(以 /api/v1/account 返回的 rate_per_min、quota_daily 为准;上面是试用 key 的值),超出回 429。另外整表快照、不带比赛 id 的统计列表等重型请求全站同时只处理 2 个,排不上回 429 + Retry-After。响应里暂时没有 X-RateLimit-* 头。 详见通用说明

请求参数 2

参数类型必填示例说明
competition_idinteger必填287赛事id
lottery_idstring必填彩种类型，101-竞彩足球、301-北单胜负过关、404-北单让球胜平负、401-14场胜负

请求示例

curl "https://api.sports.csap.ai/api/v1/matches/schedule/param?competition_id=287" \
  -H "X-API-Key: YOUR_API_KEY"

在线调试

示例返回

下面是 2026/11/09 22:28(北京时间) 用外部 key 实际请求的返回:HTTP 200,1000 行,496 ms(数据只留前 2 行)

{
  "code": 0,
  "data": [
    {
      "agg_score": null,
      "asian_handicap": null,
      "assistant1": null,
      "assistant2": null,
      "assistant_var": null,
      "away_corner": 0,
      "away_ot": 0,
      "away_pen": 0,
      "away_position": null,
      "away_red": 0,
      "away_score": 4,
      "away_scores": 2,
      "away_team": "Portugal U16",
      "away_team_id": "9oj7x9ip26fr7g3",
      "away_yellow": 0,
      "away_zh": null,
      "comp_ref": "mo07dnidvaxknxy",
      "competition_id": "mo07dnidvaxknxy",
      "coverage": null,
      "created_at": "2026-11-03T11:44:09.982905Z",
      "cur_period_start": null,
      "ended": null,
      "environment": null,
      "fourth": null,
      "from_schedule": false,
      "group_num": null,
      "half_away": 2,
      "half_home": 1,
      "has_ot": null,
      "home_corner": 0,
      "home_ot": 0,
      "home_pen": 0,
      "home_position": null,
      "home_red": 0,
      "home_score": 1,
      "home_scores": 1,
      "home_team": "Scotland U16",
      "home_team_id": "jr7owil613b3q0e",
      "home_yellow": 0,
      "home_zh": null,
      "humidity": null,
      "id": 1,
      "inferred_reason": null,
      "intelligence": null,
      "issue": null,
      "issue_num": null,
      "last_change_ts": 1793787334,
      "league": "International Friendly",
      "lineup": null,
      "loss": null,
      "lottery": null,
      "match_time": "2026-11-03T09:30:00Z",
      "minute": null,
      "mlive": null,
      "neutral": null,
      "note": null,
      "ou_line": null,
      "period_initial": null,
      "pressure": null,
      "query": null,
      "referee_id": null,
      "referee_name": null,
      "referees": null,
      "related_id": null,
      "round": null,
      "round_num": null,
      "season_id": null,
      "source": "S5",
      "source_id": "34kgmig2e5dceko",
      "stage_id": null,
      "start_ts": "2026-11-03T09:30:00Z",
      "status_code": 8,
      "status_id": 8,
      "status_inferred": false,
      "status_type": "finished",
      "tbd": null,
      "team_reverse": null,
      "temperature": null,
      "type": null,
      "updated_at": 1793787333971,
      "var": null,
      "venue_id": null,
      "venue_name": null,
      "version": 2,
      "weather": null,
      "wind": null
    },
    {
      "agg_score": null,
      "asian_handicap": null,
      "assistant1": null,
      "assistant2": null,
      "assistant_var": null,
      "away_corner": 4,
      "away_ot": 0,
      "away_pen": 0,
      "away_position": null,
      "away_red": 0,
      "away_score": 3,
      "away_scores": 0,
      "away_team": "Al-BaqaA U20",
      "away_team_id": "g6763i4164cp7ry",
      "away_yellow": 4,
      "away_zh": null,
      "comp_ref": "5xvkjoi8l5br793",
      "competition_id": "5xvkjoi8l5br793",
      "coverage": null,
      "created_at": "2026-11-03T11:44:10.006825Z",
      "cur_period_start": null,
      "ended": null,
      "environment": null,
      "fourth": null,
      "from_schedule": false,
      "group_num": null,
      "half_away": 0,
      "half_home": 1,
      "has_ot": null,
      "home_corner": 3,
      "home_ot": 0,
      "home_pen": 0,
      "home_position": null,
      "home_red": 0,
      "home_score": 2,
      "home_scores": 1,
      "home_team": "Ittihad Al-Ramtha U20",
      "home_team_id": "wv78xin089inkrj",
      "home_yellow": 1,
      "home_zh": null,
      "humidity": null,
      "id": 2,
      "inferred_reason": null,
      "intelligence": null,
      "issue": null,
      "issue_num": null,
      "last_change_ts": 1793721245,
      "league": "JOR C U20",
      "lineup": null,
      "loss": null,
      "lottery": null,
      "match_time": "2026-11-03T14:00:00Z",
      "minute": null,
      "mlive": null,
      "neutral": null,
      "note": null,
      "ou_line": null,
      "period_initial": null,
      "pressure": null,
      "query": null,
      "referee_id": null,
      "referee_name": null,
      "referees": null,
      "related_id": null,
      "round": null,
      "round_num": null,
      "season_id": null,
      "source": "S5",
      "source_id": "34kgmig2e96beko",
      "stage_id": null,
      "start_ts": "2026-11-03T14:00:00Z",
      "status_code": 8,
      "status_id": 8,
      "status_inferred": false,
      "status_type": "finished",
      "tbd": null,
      "team_reverse": null,
      "temperature": null,
      "type": null,
      "updated_at": 1793721550277,
      "var": null,
      "venue_id": null,
      "venue_name": null,
      "version": 22,
      "weather": "23°C",
      "wind": null
    }
  ],
  "message": "success",
  "success": true
}

返回字段 86

agg_scorenull可为空双回合常规时间(包括加时时间)总比分 字段说明 · example：[3, 6]
asian_handicapnull可为空亚盘
assistant1null可为空助理裁判1
assistant2null可为空助理裁判2
assistant_varnull可为空var助理裁判 字段说明 · example：[6261, 6262]
away_cornerinteger可为空客队角球数示例: 0
away_otinteger可为空客队加时比分示例: 0
away_peninteger可为空客队点球大战比分示例: 0
away_positionnull可为空客队排名
away_redinteger可为空客队红牌数示例: 0
away_scoreinteger可为空客队比分(常规时间,含补时)示例: 4
away_scoresinteger可为空比分字段说明 · example：[1, 0, 0, 0, -1, 0, 0]示例: 2
away_teamstring客队名(英文)示例: "Portugal U16"
away_team_idstring客队id示例: "9oj7x9ip26fr7g3"
away_yellowinteger可为空客队黄牌数示例: 0
away_zhnull可为空客队中文名
comp_refstring来源内的赛事 id示例: "mo07dnidvaxknxy"
competition_idstring赛事 id示例: "mo07dnidvaxknxy"
coveragenull可为空动画、情报、阵容 字段
created_atstring创建时间示例: "2026-11-03T11:44:09.982905Z"
cur_period_startnull可为空当前阶段开始时间(Unix 秒)
endednull可为空结束时间（有数据时返回）
environmentnull可为空比赛环境,有数据才有此字段
fourthnull可为空第四官员
from_scheduleboolean是否取自赛程示例: false
group_numnull可为空第几组，1-A、2-B以此类推
half_awayinteger可为空客队半场比分示例: 2
half_homeinteger可为空主队半场比分示例: 1
has_otnull可为空是否有加时 1.是（有数据时返回）
home_cornerinteger可为空主队角球数示例: 0
home_otinteger可为空主队加时比分示例: 0
home_peninteger可为空主队点球大战比分示例: 0
home_positionnull可为空主队排名
home_redinteger可为空主队红牌数示例: 0
home_scoreinteger可为空主队比分(常规时间,含补时)示例: 1
home_scoresinteger可为空比分字段说明 · example：[1, 0, 0, 0, -1, 0, 0]示例: 1
home_teamstring主队名(英文)示例: "Scotland U16"
home_team_idstring主队id示例: "jr7owil613b3q0e"
home_yellowinteger可为空主队黄牌数示例: 0
home_zhnull可为空主队中文名
humiditynull可为空湿度
idinteger记录 id;翻页游标(id 参数取 >= 此值的记录)。比赛类接口里是我方比赛 id(gmid)示例: 1
inferred_reasonstring可为空推断原因示例: "notstarted_exceeded_180m"
intelligencenull可为空是否有情报，1-是、0-否
issuenull可为空彩票期号（竞彩无期号，为空）
issue_numnull可为空序号
last_change_tsinteger可为空最后变动时间(Unix 秒)示例: 1793787334
leaguestring赛事名(英文)示例: "International Friendly"
lineupnull可为空是否有阵容，1-是、0-否
lossnull可为空是否判负 1.是（有数据时返回）
lotterynull可为空彩票期号、序号（lottery 体彩查询存在）
match_timestring开赛时间(UTC,ISO 8601)示例: "2026-11-03T09:30:00Z"
minutestring可为空比赛进行分钟示例: "45'"
mlivenull可为空是否有动画，1-是、0-否
neutralnull可为空是否中立场，1-是、0-否
notenull可为空备注
ou_linenull可为空大小球盘口
period_initialnull可为空当前阶段起始分钟
pressurenull可为空气压
querynull可为空查询信息(翻页游标、总数)
referee_idnull可为空裁判id
referee_namenull可为空裁判名
refereesnull可为空裁判组,有数据才有此字段
related_idnull可为空双回合中另一回合比赛id
roundnull可为空轮次
round_numnull可为空第几轮
season_idnull可为空赛季 id
sourcestring数据来源代号(S1、S2…)示例: "S5"
source_idstring来源内的 id示例: "34kgmig2e5dceko"
stage_idnull可为空阶段id
start_tsstring开赛时间(UTC,ISO 8601)示例: "2026-11-03T09:30:00Z"
status_codeinteger状态码示例: 8
status_idinteger比赛状态码(见状态与类型码对照表)示例: 8
status_inferredboolean状态是否为推断示例: false
status_typestring比赛状态:notstarted 未开赛 / inprogress 进行中 / finished 已结束 等示例: "finished"
tbdnull可为空比赛时间是否待定 1.是（有数据时返回）
team_reversenull可为空是否主客相反 1.是（有数据时返回 eg：相反-官网A vs B、本平台B vs A）
temperaturenull可为空温度
typenull可为空类型
updated_atinteger最后更新时间(UTC,ISO 8601;增量同步用 time 参数按它取)示例: 1793787333971
varnull可为空var裁判
venue_idnull可为空场馆id
venue_namenull可为空场馆名
versioninteger版本号(越大越新)示例: 2
weatherstring可为空天气id · 1:局部有云 · 2:多云 · 3:局部有云/雨 · 4:雪 · 5:晴 · 6:阴有雨/局部有雷暴 · 7:阴 · 8:薄雾 · 9:阴有雨 · 10:多云有雨 · 11:多云有雨/局部有雷暴 · 12:局部有云/雨和雷暴 · 13:雾示例: "23°C"
windnull可为空风速

错误码

HTTPmessage场景
401missing API key / unauthorized没带 X-API-Key 或 key 无效、已停用
429rate limit exceeded / daily quota exceeded超过 key 的每分钟次数或每日配额
429server busy, retry later服务端并发名额已满(重型请求同时只有 2 个),按 Retry-After 秒后重试
500query error服务端查询失败,可重试