赔率数据 API

以机器可读的 JSON 提供 10 家博彩公司、7 个项目、69 个联赛的赛前赔率。无需注册,用免费密钥即可立即开始。

10
博彩公司
7
项目
69
联赛
296
未来 7 天比赛
3194
有收盘赔率记录的比赛

与网站页面有何不同

网站页面依旧免费,且没有额外延迟。API 提供页面上没有的内容。

  • 机器 JSON比赛、联赛、球队、博彩公司使用同一套 ID,10 家博彩公司格式统一
  • 一次取全每场比赛的所有博彩公司、盘口与线(页面一次只显示一张表)
  • 逐行新鲜度通过 changed_at、seen_at、age_sec、suspended 让程序判断过时数据
  • 只取变化用 since 游标只获取上次请求后有变化的比赛
  • 收盘赔率记录 即将推出已结束比赛各博彩公司的收盘价与赛果
  • 自有赔率 即将推出基于赛果的模型给出的概率与公平赔率,并公开成绩表
  • 完整的组合、中间盘、偏差列表 即将推出每条腿的经过秒数与实际核对状态

价格 即将推出

付费使用即将推出。目前仅开放免费层,以下为计划价格。

首次获取某场比赛时一次性收取 0.03 USDT。之后在开赛前调用该比赛不再额外收费(请求上限每分钟 120 次),每月合计不超过 49 USDT。经筛选后没有剩余数据的比赛和没有赔率的比赛不扣费。

产品价格条件
赔率(最新,无额外延迟)0.03 USDT / 场所有博彩公司、盘口与线,开赛后含收盘赔率与赛果 · 月上限 49 USDT · 实测延迟表 →
自有赔率+0.01 USDT / 场足球胜平负概率与公平赔率 · 月上限 9 USDT
组合、中间盘与偏差5 USDT / 30 天完整列表与筛选 · 30 天使用权,可选自动续期
收盘赔率记录0.01 USDT / 场已结束比赛各博彩公司的收盘价(主线)· 不计入月上限(计入月度支出上限)
免费0延迟 5–10 分钟的快照 · 仅主线 · 每天 20 场 · 每小时 100 次
示例(按最近 30 天已结束的比赛数)
范围每月比赛费用
指定 5 场比赛50.15 USDT
仅 Friendly International约 91约 2.73 USDT
全部足球约 699约 20.97 USDT
全部约 2240上限 49 USDT

支付:USDT 预付(BSC、TRON),最低充值 10 USDT。无需注册,直接为密钥充值。

上调价格或月上限、下调免费或请求上限的变更,自公告之日起满 7 天后的第一个月 1 日起生效。对用户有利的变更立即生效。

获取免费密钥

无需注册 · 延迟 5–10 分钟的快照 · 每天 20 场

快速开始

三步:① 获取密钥 ② 选择范围(/meta/leagues)③ 用 /quote 确认费用后调用 /odds。

export ODDSBUNCH_KEY=obd_...            # the key from POST /keys
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/meta/leagues?sport=soccer"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/quote?league=386"
curl -s --compressed -H "Authorization: Bearer $ODDSBUNCH_KEY" "https://oddsbunch.com/api/data/v1/odds?league=386&limit=5&main_only=true&markets=1x2"

示例从环境变量 ODDSBUNCH_KEY 读取密钥。请勿把密钥直接写进代码。

自有赔率(oddsbunch-model-v1) 即将推出

足球胜平负概率与公平赔率(1÷概率)。这是基于历史赛果与球员记录得出的估计值,并非照搬博彩公司赔率。

每个响应都附带依据(basis:lineup、time)、赛前数据是否完整(pre_complete)、计算时间(computed_at),以及因阵容变化重新计算的历史。是否完整的最终判定(complete)在赛后给出。

实战成绩(2026-10-20 至 2026-11-18,与同一时点的博彩公司共识在同一批比赛上比较)

完整数据 348 场无明显差异Brier 差 +0.0045 ± 0.0059
不完整数据 244 场逊于博彩公司Brier 差 +0.0469 ± 0.0126
无确定阵容时给出的值(time)101 场逊于博彩公司Brier 差 +0.0603 ± 0.0215

是否完整在赛后判定 · 赛前以 pre_complete 表示。 不完整数据比赛的数值仅供参考。成绩表每日更新,免费提供。

虚拟选择收益率(虚拟 — 非真实投注):+3.7% · 322 个

AI 代理

设计为几乎无需人工即可完成接入。

  • OpenAPI 3.1 规范 — https://oddsbunch.com/api/data/v1/openapi.json
  • Markdown 全文(docs.md) — https://oddsbunch.com/api/data/v1/docs.md
  • llms.txt
  • /quote 在不扣费的情况下计算费用,代理可以先征求用户同意。还可以用 max_charge、buy=false 和月度支出上限在服务器端限制花费。
  • 每个错误都附带下一步操作(fix)和文档地址(docs)。
  • MCP 服务器即将推出。

让 AI 代理发布会员分析文章的 API 是另一套。 公告“API · AI 代理”→

常见问题

可以用程序抓取网站页面吗?

页面供人浏览,服务条款禁止自动采集。需要机器读取请使用本 API。免费密钥从延迟的主线数据开始。

多次调用同一场比赛会重复收费吗?

(即将推出) 不会。每场比赛仅在首次获取时扣费一次,同一账户的所有密钥在开赛前共享(含开赛后的收盘赔率与赛果)。

达到月上限后会怎样?

(即将推出) 当月(UTC 自然月)剩余比赛不再扣赔率费用。即使获取全部,每月也不超过 49 USDT。上限按比赛开始的月份计算,下月比赛计入下月上限。

余额不足怎么办?

(即将推出) 已获取的比赛照常返回,新比赛会被排除,并告知未能获取的场数(unpaid_matches)和充值方法。绝不会悄悄切换为延迟数据。

充值的钱可以退回吗?

(即将推出) 仅凭密钥创建的账户余额不可提现,只能用于 API(终止数据 API 时的退还除外)。网站会员创建的密钥遵循网站的提现规则。若在采集中断期间购买了该比赛或该比赛已开赛,且中断期间该比赛赔率未更新(买到的是停止更新的数据),该赔率费用会在开赛后自动退回(自有赔率与收盘赔率记录除外);已退款的比赛失效,其金额也不再计入当月上限。被取消的比赛同样自动退款。

数据有多新?

从博彩公司更新到我们同步通常约 1 分钟,慢时几分钟(文档中有分项目实测表)。每行都有 age_sec,可自行设定阈值过滤。免费密钥为延迟 5–10 分钟的快照。

可以转售或公开获取的数据吗?

服务条款第 7-2 条禁止转售或转交数据本身。在自己的分析或结果页面展示部分数值是允许的,但请注明来源为 Oddsbunch。发现被禁止的使用时,可能停用该账户的 API 使用。