DOCS
篮球 API赔率

篮球批量赔率

调试凭证使用你的 API key

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

GET
/v1/basketball/odds

篮球赔率自 2026-09-17 起采集:此前开赛的比赛没有赔率,各盘口为空数组。

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

match_id?array<string>|

比赛对外 ID,可重复传

competition_id?array<string>|

赛事对外 ID,可重复传,最多 50 个

season_id?|

赛季对外 ID

date_from?|

开赛日期下限(含),按北京时间的日期

date_to?|

开赛日期上限(含),按北京时间的日期

updated_since?|

只返回此时间之后更新过的赔率行(含),ISO 8601,可带任意时区偏移;不带偏移按 +08:00。比赛本身仍按上面的范围条件筛选——这个参数收窄的是每场返回哪些赔率行

type?array<>|

赔率类型,可重复传;不传返回全部三种

bookmaker_id?|

只取这家公司(对外 ID)

main_only?Main Only

只返回主流公司,仅对 euro 有效

默认值true
has_odds?Has Odds

为 true 时只返回有赔率的比赛:在所选 type、公司(及 updated_since)下至少有一行,分页总数随之变化。不传或为 false 时范围内的比赛都返回,没有赔率的各盘口为空数组

默认值false
limit?Limit

每页比赛数,最大 50(一场比赛携带几十行赔率,故比其它列表更小)

范围1 <= value <= 50
默认值20
offset?Offset

起始偏移

范围0 <= value
默认值0

响应体

Successful Response

application/json
  1. response
data*array<>

本页数据

pagination*

分页信息