DOCS
足球 API比赛

足球单场赔率

调试凭证使用你的 API key

仅在本页使用,刷新后清除。在线调试会使用你的调用额度。

GET
/v1/soccer/matches/{match_id}/odds

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

路径参数

match_id*Match Id

查询参数

type?array<>|

赔率类型,可重复传(如 type=euro&type=ou):euro 欧指 / handicap 让球 / ou 大小球 / corner 角球。不传返回全部四种

period?Period

ft 全场 / ht 半场(半场盘覆盖很少,多数比赛为空)

默认值"ft"
可选值"ft""ht"
bookmaker_id?|

只取这家公司(对外 ID);欧指与让球 / 大小球 / 角球是两套公司体系,ID 不通用

main_only?Main Only

只返回主流公司。仅对 euro 有效;亚盘体系的公司没有主流标记,传入时忽略、返回全部公司

默认值true

响应体

Successful Response

application/json
  1. response

与篮球 OddsEnvelope 同形:只有 data 一个顶层键

全市场共识曾是这里的第三个顶层键 consensus,且只在 type=euro && period=ft 时非 null。 它现在是自己的子资源 /matches/{id}/odds/consensus——顶层形状因此和其它集合一致, 那个"看参数才知道有没有值"的条件字段也不必再在响应里解释。

data*

该场赔率,按盘口分组;无赔率为空数组。不分页