赔率数据 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 次 |
| 范围 | 每月比赛 | 费用 |
|---|---|---|
| 指定 5 场比赛 | 5 | 0.15 USDT |
| 仅 Friendly International | 约 91 | 约 2.73 USDT |
| 全部足球 | 约 699 | 约 20.97 USDT |
| 全部 | 约 2240 | 上限 49 USDT |
支付:USDT 预付(BSC、TRON),最低充值 10 USDT。无需注册,直接为密钥充值。
上调价格或月上限、下调免费或请求上限的变更,自公告之日起满 7 天后的第一个月 1 日起生效。对用户有利的变更立即生效。
获取免费密钥
快速开始
三步:① 获取密钥 ② 选择范围(/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"import os, requests
H = {"Authorization": f"Bearer {os.environ['ODDSBUNCH_KEY']}"}
r = requests.get("https://oddsbunch.com/api/data/v1/odds", params={"league": 386, "limit": 5}, headers=H, timeout=30).json()
print(r["billing"], len(r["data"]))const H = { Authorization: `Bearer ${process.env.ODDSBUNCH_KEY}` };
const r = await (await fetch("https://oddsbunch.com/api/data/v1/odds?league=386&limit=5", { headers: H })).json();
console.log(r.billing, r.data.length);
示例从环境变量 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 使用。