足球 API赔率
足球批量赔率
调试凭证使用你的 API key
仅在本页使用，刷新后清除。在线调试会使用你的调用额度。
GET
一次取一批比赛的赔率，省掉「每场每盘口各发一次请求」
跟一个联赛原先要 380 场 × 4 种盘口 = 1520 次请求，按列表类 300 次/分钟的额度光拉 一轮就要 5 分钟以上；现在一轮 8 次请求（每页 50 场）拿完。
必须给至少一个比赛范围条件（match_id / competition_id / season_id / 日期）， 否则就是在全库比赛上扫赔率表。
APIKeyHeaderheader
X-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<>|赔率类型，可重复传；不传返回全部四种
period?Periodft 全场 / ht 半场
默认值
"ft"可选值
"ft""ht"bookmaker_id?|只取这家公司（对外 ID）
main_only?Main Only只返回主流公司，仅对 euro 有效
默认值
truehas_odds?Has Odds为 true 时只返回有赔率的比赛：在所选 type、period、公司（及 updated_since）下至少有一行，分页总数随之变化。不传或为 false 时范围内的比赛都返回，没有赔率的各盘口为空数组
默认值
falselimit?Limit每页比赛数，最大 50（一场比赛携带几十到上百行赔率，故比其它列表更小）
范围
1 <= value <= 50默认值
20offset?Offset起始偏移
范围
0 <= value默认值
0Successful Response
application/json- response
data*array<>本页数据
pagination*分页信息