GET/api/v1/live

进行中比分板

实时数据包activebetacore可调用(数据有范围)

调用信息

请求: GET https://api.sports.csap.ai/api/v1/live
鉴权: 请求头 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-* 头。详见通用说明

请求参数 3

参数	类型	必填	示例	说明
competition	string	可选		赛事名过滤(模糊)
gcid	integer	可选	`287`	我方赛事 id
limit	integer	可选	`2`	返回条数,默认 50,最大 500

请求示例

curl "https://api.sports.csap.ai/api/v1/live?limit=2" \
  -H "X-API-Key: YOUR_API_KEY"

在线调试

示例返回

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

{
  "code": 0,
  "data": [
    {
      "away_corner": 4,
      "away_gtid": 7190,
      "away_logo": "http://43.99.60.51:8080/logos/f6308f1df4bfc089793dd452628bc5f37bf2d6e80d63f884e8457560f5f66468.png",
      "away_red": 0,
      "away_score": 1,
      "away_team": "GS Niki Volou",
      "away_yellow": 1,
      "away_zh": "尼基沃罗",
      "comp_logo": "http://43.99.60.51:8080/logos/6e8ccfeeed779ad0cec7fd44afad84a534a4ec3d80d32337d73247220a58f119.png",
      "cur_period_start": 1794232786,
      "gcid": 736,
      "gmid": "6838",
      "half_away": 0,
      "half_home": 0,
      "home_corner": 7,
      "home_gtid": 7189,
      "home_logo": "http://43.99.60.51:8080/logos/6d285015517474f8c1a8e872fee94d872f55f0330fb553aac7719978698b78a4.png",
      "home_red": 0,
      "home_score": 0,
      "home_team": "APS Zakynthos 1961",
      "home_yellow": 1,
      "home_zh": "扎金索斯",
      "id": "6838",
      "league": "Superbet League 2",
      "league_zh": "希腊甲",
      "match_time": "2026-11-09T13:00:00Z",
      "minute": "75",
      "period_initial": 2700,
      "sources": "S5,S9,S4,S3,S2,S7",
      "start_ts": "2026-11-09T13:00:00Z",
      "status": "inprogress",
      "status_id": 4,
      "updated_at": "2026-11-09T14:28:42.226675Z"
    },
    {
      "away_corner": 0,
      "away_gtid": 3544,
      "away_logo": "http://43.99.60.51:8080/logos/2c16d31304410421c146eabbba52fcf46b2c20e8bc5cfb5c9c8a7d58f89d9892.webp",
      "away_red": 0,
      "away_score": 0,
      "away_team": "Palayesh Naft Bandar Abbas FC",
      "away_yellow": 0,
      "away_zh": "阿巴斯港石油",
      "comp_logo": "http://43.99.60.51:8080/logos/c9b7afcc9db847eb44761dbadee0fd93de78ff6be7a74e0abc0d39a3ba4a2234.png",
      "cur_period_start": 1794233880,
      "gcid": 1463,
      "gmid": "4130",
      "half_away": 0,
      "half_home": 2,
      "home_corner": 0,
      "home_gtid": 3543,
      "home_logo": "http://43.99.60.51:8080/logos/41dec58589c6edfb9419e8245820f4cdab184b7789ade7f8b6daaecc6545a3a4.webp",
      "home_red": 0,
      "home_score": 2,
      "home_team": "Pars Jonoubi Jam",
      "home_yellow": 0,
      "home_zh": "帕尔斯布什尔",
      "id": "4130",
      "league": "Azadegan League",
      "league_zh": "伊朗甲",
      "match_time": "2026-11-09T13:15:00Z",
      "minute": "56",
      "period_initial": 2700,
      "sources": "S5,S9,S4,S3,S2,S7",
      "start_ts": "2026-11-09T13:15:00Z",
      "status": "inprogress",
      "status_id": 4,
      "updated_at": "2026-11-09T14:28:40.22281Z"
    }
  ],
  "message": "success",
  "success": true
}

返回字段 33

away_cornerinteger客队角球数示例: 4

away_gtidinteger客队我方球队 id示例: 7190

away_logostring客队 logo(本平台的图片地址)

away_redinteger客队红牌数示例: 0

away_scoreinteger客队比分(常规时间,含补时)示例: 1

away_teamstring客队名(英文)示例: "GS Niki Volou"

away_yellowinteger客队黄牌数示例: 1

away_zhstring客队中文名示例: "尼基沃罗"

comp_logostring赛事 logo(本平台的图片地址)

cur_period_startinteger当前阶段开始时间(Unix 秒)示例: 1794232786

gcidinteger我方赛事 id示例: 736

gmidstring我方比赛 id(gmid,全平台唯一)示例: "6838"

half_awayinteger客队半场比分示例: 0

half_homeinteger主队半场比分示例: 0

home_cornerinteger主队角球数示例: 7

home_gtidinteger主队我方球队 id示例: 7189

home_logostring主队 logo(本平台的图片地址;没有时为空)

home_redinteger主队红牌数示例: 0

home_scoreinteger主队比分(常规时间,含补时)示例: 0

home_teamstring主队名(英文)示例: "APS Zakynthos 1961"

home_yellowinteger主队黄牌数示例: 1

home_zhstring主队中文名示例: "扎金索斯"

idstring记录 id;翻页游标(id 参数取 >= 此值的记录)。比赛类接口里是我方比赛 id(gmid)示例: "6838"

leaguestring赛事名(英文)示例: "Superbet League 2"

league_zhstring赛事中文名示例: "希腊甲"

match_timestring开赛时间(UTC,ISO 8601)示例: "2026-11-09T13:00:00Z"

minutestring比赛进行分钟示例: "75"

period_initialinteger当前阶段起始分钟示例: 2700

sourcesstring这条合并记录的来源代号列表(逗号分隔)示例: "S5,S9,S4,S3,S2,S7"

start_tsstring开赛时间(UTC,ISO 8601)示例: "2026-11-09T13:00:00Z"

statusstring比赛状态示例: "inprogress"

status_idinteger比赛状态码(见状态与类型码对照表)示例: 4

updated_atstring最后更新时间(UTC,ISO 8601;增量同步用 time 参数按它取)示例: "2026-11-09T14:28:42.226675Z"

错误码

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