賠率資料 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 使用。