GET/api/v1/matches/odds

获取实时指数数据

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

接口说明

返回实时变动的赔率数据，无赔率变动的比赛不返回
只返回最近60秒变化的赔率数据，需要客户自身把变动数据记录下来

范围：初盘、即时盘、滚球盘
每家公司每种指数的第一个盘口，即为初盘；初盘到开球为即时盘；开球后为滚球盘

建议请求频次：3秒/次

调用信息

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

请求参数 0

该接口无请求参数。

请求示例

curl "https://api.sports.csap.ai/api/v1/matches/odds" \
  -H "X-API-Key: YOUR_API_KEY"

在线调试

示例返回

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

{
  "code": 0,
  "data": [
    {
      "ah_away": 1.87,
      "ah_home": 0.49,
      "ah_line": 0,
      "corner_line": 9.5,
      "corner_over": 3.68,
      "corner_under": 1.34,
      "eu_away": null,
      "eu_draw": null,
      "eu_home": null,
      "match_source": "S5",
      "open_ah_line": null,
      "open_ou_line": null,
      "ou_line": 2.5,
      "ou_over": 0.6,
      "ou_under": 1.15,
      "updated_at": 1793706857190,
      "version": 42,
      "公司id": null
    },
    {
      "ah_away": 0.84,
      "ah_home": 1.1,
      "ah_line": 0.75,
      "corner_line": null,
      "corner_over": null,
      "corner_under": null,
      "eu_away": null,
      "eu_draw": null,
      "eu_home": null,
      "match_source": "S5",
      "open_ah_line": null,
      "open_ou_line": null,
      "ou_line": 6,
      "ou_over": 1.1,
      "ou_under": 0.84,
      "updated_at": 1793707705366,
      "version": 153,
      "公司id": null
    }
  ],
  "message": "success",
  "success": true
}

返回字段 19

ah_awaynumber亚盘客队水位示例: 1.87

ah_homenumber亚盘主队水位示例: 0.49

ah_lineinteger亚盘盘口示例: 0

corner_linenumber可为空角球盘口示例: 9.5

corner_overnumber可为空角球大水位示例: 3.68

corner_undernumber可为空角球小水位示例: 1.34

eu_awaynull可为空欧赔客胜

eu_drawnull可为空欧赔平

eu_homenull可为空欧赔主胜

match_sourcestring这行数据的来源代号示例: "S5"

gmidinteger可为空我方比赛 id(gmid,全平台唯一)

open_ah_linenull可为空初盘亚盘盘口

open_ou_linenull可为空初盘大小球盘口

ou_linenumber可为空大小球盘口示例: 2.5

ou_overnumber可为空大球水位示例: 0.6

ou_undernumber可为空小球水位示例: 1.15

updated_atinteger最后更新时间(UTC,ISO 8601;增量同步用 time 参数按它取)示例: 1793706857190

versioninteger版本号(越大越新)示例: 42

公司idnull可为空指数公司id，详见状态码->指数公司ID

错误码

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`	服务端查询失败,可重试