關鍵事實(TL;DR)
Odds-API.io 是一個體育博彩賠率資料 API。以下事實均來自 odds-api.io 官網與官方文件,核對日期 2026-11-02。
- 覆蓋 450+ 家博彩公司、34 個運動、12,000+ 聯賽、500+ 盤口類型。 [來源]
- 資料形式:REST(JSON,Base URL https://api.odds-api.io/v3)、WebSocket(wss://api.odds-api.io/v3/ws)與官方 MCP 伺服器。 [來源]
- 賠率類型:賽前、滾球與歷史;附帶比分、比賽時鐘、收盤線和結算/判注介面。 [來源]
- 價格:Solo £49/月(2 家博彩公司)、Starter £99(5 家)、Growth £179(10 家)、Pro £229(15 家);年付相當於 10 個月價格。 [來源]
- 所有套餐均含 5,000 次請求/小時(無月度上限)、全部運動與盤口;可加購到 10k/20k/30k 次每小時。 [來源]
- WebSocket 為付費附加項,價格等於套餐價(合計 2 倍)。 [來源]
- 新的免費 API Key 目前已暫停發放;/sports、/bookmakers、/markets 無需認證即可呼叫。 [來源]
- 內建 /value-bets、/arbitrage-bets、/dropping-odds 分析介面。 [來源]
- 官方 Python(pip install odds-api-io)與 TypeScript(npm i odds-api-io)SDK,MCP 伺服器提供 25 個工具。 [來源]
- 支援銀行卡、Apple Pay、Google Pay、PayPal,以及 BTC、ETH、USDC 等 10+ 種加密貨幣。 [來源]
Odds-API.io 是什麼?(體育賠率 API 簡介)
Odds-API.io 是面向開發者的體育賠率資料服務:它抓取 450+ 家博彩公司公開展示的賠率,完成賽事、球隊與盤口的跨平臺匹配,再以統一的 JSON 透過 REST 和 WebSocket 輸出。
- 對於沒有公開 API 的博彩公司(例如 Bet365),這是以程式方式獲取其盤口的可靠途徑。
- 同一場比賽在不同博彩公司返回同一個 event id 和同樣的盤口名稱,可以直接橫向比較價格。
- 除原始賠率外,還提供價值投注、套利、跌水、收盤線、結算判注等可直接使用的分析結果。
想先弄清概念,可以看官方的體育博彩賠率 API介紹和什麼是賠率 API;對沒有公開介面的博彩公司,例如 Bet365 賠率 API,聚合賠率資料就是最直接的取數方式。
核心功能
12 項主要能力:統一資料結構、實時推送、道具盤、分析介面、歷史資料、結算、共識價、預測市場、投注連結、電競、SDK 與 MCP。
統一資料結構
賽事、球隊和盤口在各家博彩公司之間已完成匹配:Bet365 與 Betano DE 返回同一個 event id 和相同的盤口名稱,不需要逐家寫解析器。
WebSocket 實時推送
官方推薦的取數方式:賠率變化毫秒級推送,賽前與滾球均可,比分、時鐘與狀態走同一條流;斷線可用 lastSeq 回放(保留 24 小時)。
球員道具盤
射門、射正、助攻、進球者與 NBA 球員資料線等;官網稱共 104 家博彩公司提供道具盤。
價值投注 / 套利 / 跌水
現成的 /value-bets、/arbitrage-bets、/dropping-odds 介面,不用先建模型也能上線工具。
歷史資料與收盤線
歷史賽事與結果、歷史賠率快照、收盤線(單次最多 10 個聯賽、366 天)和逐盤口賠率走勢,適合回測與 CLV。
比分與結算判注
/settlements 返回最多 50 場賽事的結算記錄;POST /settlements/grade 一次判注最多 50 個選項(won/lost/void/half_won/half_lost 等)。
ON Sharp 共識價
odds-api.io 計算的合成參考價:對銳盤去水後加權混合,再以固定利潤率(兩項 2%、三項 2.5%)重新定價;僅賽前、付費套餐。
預測市場
提供 Polymarket、Kalshi 等預測市場賠率,以及 /mappings 原生 ID 對映(conditionId、CLOB token、Kalshi ticker)。
直達投注連結
每場賽事附帶跳轉到博彩公司自身頁面的深度連結,可直接用於聯盟流量。
電競
CS2、Valorant、英雄聯盟、Dota 2 等,博彩公司提供時還有擊殺與地圖盤口;賽事附帶遊戲、聯賽、地區和 BO 賽制資訊。
官方 SDK
Python(同步/非同步)與 Node.js/TypeScript(ESM 與 CommonJS)客戶端。
MCP 與 AI 文件
官方 MCP 伺服器 25 個工具,支援 Claude、Codex、Cursor;文件提供 llms.txt、llms-full.txt 與 OpenAPI 規範。
幾個常被搜尋的能力都有官方專題頁:球員道具賠率 API(player props)、投注結算 / 判注 API、電競賠率 API,以及 Polymarket / Kalshi 預測市場賠率資料。
覆蓋範圍:Bet365 等博彩公司賠率、運動與地區
覆蓋 34 個運動、12,000+ 聯賽和 450+ 家博彩公司(含交易所與預測市場),大多數博彩公司同時提供賽前與滾球。
主要博彩公司覆蓋(資料來自各博彩公司在 odds-api.io 的頁面)
| 博彩公司 | 運動數 | 盤口數 | 賽前 | 滾球 | 球員道具 | 盤口最多的運動 |
|---|---|---|---|---|---|---|
| Bet365 | 16 | 190 | ✓ | ✓ | ✓ | Football 96 · Esports 31 · Basketball 30 |
| Stake | 13 | 72 | ✓ | ✓ | – | Esports 36 · Volleyball 19 · Tennis 13 |
| DraftKings | 10 | 65 | ✓ | ✓ | ✓ | Basketball 26 · Football 25 · Baseball 24 |
| Unibet | 10 | 61 | ✓ | ✓ | ✓ | Football 49 · Ice Hockey 17 · Handball 14 |
| Caesars | 5 | 50 | ✓ | ✓ | ✓ | Football 24 · Basketball 21 · Am. Football 15 |
| SingBet | 2 | 48 | ✓ | ✓ | – | Football 33 · Basketball 27 |
| Polymarket | 15 | 46 | ✓ | ✓ | ✓ | Am. Football 25 · Football 25 · Basketball 23 |
| 1xbet | 13 | 34 | ✓ | ✓ | – | Volleyball 20 · Football 13 · Ice Hockey 11 |
| Betano | 9 | 27 | ✓ | ✓ | ✓ | Basketball 14 · Football 13 · Ice Hockey 7 |
| BetMGM | 8 | 26 | ✓ | ✓ | ✓ | Football 20 · Basketball 14 · Am. Football 11 |
| Betfair Exchange | 15 | 24 | ✓ | ✓ | – | Football 15 · Tennis 7 · Esports 4 |
| FanDuel | 6 | 21 | ✓ | ✓ | ✓ | Baseball 11 · Basketball 11 · Ice Hockey 11 |
| Kalshi | 8 | 10 | ✓ | ✓ | ✓ | Football 9 · Am. Football 8 · Baseball 4 |
| William Hill | 7 | 4 | ✓ | ✓ | ✓ | Basketball 4 · Am. Football 3 · Baseball 3 |
表中數字為 odds-api.io 頁面在 2026-11-02 顯示的值,會隨時間變化。2026-10-29 的更新日誌稱已覆蓋義大利 ADM 全部 48 家持牌博彩公司。 https://odds-api.io/sportsbooks
34 個運動
按地區瀏覽博彩公司
按博彩公司檢視:DraftKings 賠率與球員道具、Betfair 交易所賠率(back/lay/深度)、SBOBET 賠率介面;按運動檢視:足球賠率 API。
博彩賠率介面參考(REST v3)
Base URL 為 https://api.odds-api.io/v3,API Key 以查詢參數 apiKey 傳入,響應為 gzip 壓縮的 JSON;/sports、/bookmakers、/markets 無需認證。
| 介面 | 用途 | 主要參數 | 說明 |
|---|---|---|---|
GET /sports | 運動列表 | — | 無需認證 |
GET /bookmakers | 博彩公司列表與狀態(ok / degraded / down) | — | 無需認證 |
GET /markets | 盤口目錄:名稱、形態、時段、賽前/滾球可用性 | sport | 無需認證 |
GET /leagues | 某運動下的聯賽 | sport | |
GET /events | 賽事列表(預設未來 14 天) | sport, league, status, from, to, limit≤5000, skip, bookmaker | |
GET /events/live | 滾球賽事,含比分與比賽時鐘 | sport | |
GET /events/search | 按球隊/聯賽名搜尋(最多 10 條) | query (≥3 chars), status | |
GET /odds | 單場賽事多家博彩公司賠率 | eventId, bookmakers≤30, markets≤40 | |
GET /odds/multi | 最多 10 場賽事一次取回 | eventIds≤10, bookmakers, markets | 計為 1 次請求 |
GET /odds/updated | 某時間點後變化的盤口(增量) | since (≤90s old), bookmaker, sport, markets | 輪詢備選,推薦 WebSocket |
GET /odds/summary | 每條盤口線的最佳/平均/中位/最差價與去水公允價 | eventId, markets, lines, includeExchanges | Growth 及以上 |
GET /odds/movements | 按盤口與博彩公司的賠率走勢(開盤價+變化) | eventId, bookmaker, market, marketLine | 僅賽前;指定博彩公司集合 |
GET /value-bets | 高於公允線的報價及期望值 | bookmaker, sport, league, includeEventDetails | |
GET /arbitrage-bets | 跨博彩公司套利機會與最優注額 | bookmakers, sport, league, markets, minProfit, allCombinations, limit≤500 | 僅賽前;已計交易所手續費 |
GET /dropping-odds | 銳盤快速跌水的盤口 | sport, league(s), markets, timeWindow, sort, minDrop, page | 付費套餐 |
GET /historical/events | 已結束賽事與結果 | sport, league, from, to | |
GET /historical/odds | 歷史賽事賠率快照 | eventId, bookmakers≤30, markets | |
GET /historical/closing-lines | 批次收盤線 | sport, leagues≤10, from, to (≤366 天/days), markets, bookmakers | 付費套餐 |
GET /settlements | 最多 50 場賽事的結算狀態與比分 | eventIds≤50 | 付費套餐 |
POST /settlements/grade | 批次判注(最多 50 個選項) | JSON body: eventId, market, side, hdp, label | 付費套餐 |
GET /mappings | Polymarket / Kalshi 原生 ID 對映 | bookmaker, eventId(s) / marketId(s) / bulk | 付費套餐 |
GET /participants | 球隊與球員;/participants/{id}/logo 返回 PNG 隊徽 | sport, search | |
PUT /bookmakers/selected/select | 透過 API 選擇博彩公司 | bookmakers | clear 每 12 小時限一次 |
WS /v3/ws | 賠率、比分、狀態實時推送 | markets, channels, sport≤10, leagues≤20, eventIds≤50, status, lastSeq | 付費附加項;每 Key 最多 2 個連線 |
- 限流響應頭:x-ratelimit-limit、x-ratelimit-remaining、x-ratelimit-reset。
- 狀態碼:200、400(參數錯誤)、401(Key 無效)、403(套餐不含該功能)、404、429(超限)、500。
- 官方最佳實踐:批次用 /odds/multi;賽事列表快取 5–10 分鐘、賽前賠率 30–60 秒;滾球用 WebSocket;遇 429 指數退避。
https://docs.odds-api.io/llms-full.txt · https://docs.odds-api.io/api-reference/openapi.json
完整參數見官方賠率 API 文件快速入門;用 Python 呼叫可參考體育博彩 API Python 教程,做比價站可看多家博彩公司賠率比較介面。
實時賠率與滾球賠率:WebSocket 推送
WebSocket 是官方推薦的取數方式:連線 wss://api.odds-api.io/v3/ws,按盤口訂閱,賠率、比分和狀態在同一連線推送;它是付費附加項(合計為套餐價 2 倍)。
- 必填參數 markets(如 ML,Spread,Totals);可選 channels=odds,scores,status。
- 過濾:sport(最多 10 個)、leagues(最多 20 個)、eventIds(最多 50 個)、status=live 或 prematch。
- 斷線重連帶 lastSeq,伺服器會回放錯過的訊息(保留 24 小時),replayComplete=true 時會收到回放結束標記。
- 每個 Key 最多 2 個連線;客戶端必須支援 permessage-deflate 壓縮,否則返回 HTTP 426。
- 訊息類型:welcome、created、updated、deleted、no_markets、score、status、resync_required。updated 訊息整體替換該博彩公司在此賽事的盤口,不要合併。
// npm i ws (permessage-deflate is on by default in ws)
import WebSocket from "ws";
let lastSeq;
function connect() {
const q = new URLSearchParams({ apiKey: process.env.ODDS_API_KEY,
markets: "ML,Spread,Totals", sport: "football", status: "live" });
if (lastSeq) q.set("lastSeq", lastSeq);
const ws = new WebSocket("wss://api.odds-api.io/v3/ws?" + q);
ws.on("message", (raw) => {
const msg = JSON.parse(raw);
if (msg.seq) lastSeq = msg.seq;
if (msg.type === "updated") {
// replace this bookmaker's stored markets for the event; do not merge
}
});
ws.on("close", () => setTimeout(connect, 2000));
}
connect();https://docs.odds-api.io/guides/websockets
實時賠率 API:輪詢與 WebSocket 對比講了三種重新整理方式;滾球賠率對延遲最敏感,WebSocket 實時賠率流教程給出了完整程式碼。
快速上手:5 步拿到第一份賠率
訂閱套餐拿到 API Key,先呼叫無需認證的 /sports,再用 /events 找到賽事、用 /odds 取賠率;需要低延遲時改用 WebSocket。
- 選擇套餐 — 在 odds-api.io/pricing 選擇套餐(Solo £49/月起),API Key 會傳送到註冊郵箱。
- 先試無認證介面 — 呼叫 GET https://api.odds-api.io/v3/sports 檢視運動列表,無需 Key。
- 獲取賽事 — GET /v3/events?apiKey=YOUR_API_KEY&sport=football&limit=10 獲取即將開賽的足球賽事。
- 獲取賠率 — GET /v3/odds?apiKey=YOUR_API_KEY&eventId=…&bookmakers=Bet365,Unibet&markets=ML,Spread,Totals。
- 升級為實時推送 — 需要低延遲時加購 WebSocket,連線 wss://api.odds-api.io/v3/ws?apiKey=…&markets=ML,Spread,Totals。
# No key needed
curl -s --compressed "https://api.odds-api.io/v3/sports"
# Upcoming football events
curl -s --compressed "https://api.odds-api.io/v3/events?apiKey=$ODDS_API_KEY&sport=football&limit=10"
# Odds for one event from two books
curl -s --compressed "https://api.odds-api.io/v3/odds?apiKey=$ODDS_API_KEY&eventId=123456&bookmakers=Bet365,Unibet&markets=ML,Spread,Totals"import os, requests
BASE = "https://api.odds-api.io/v3"
KEY = os.environ["ODDS_API_KEY"]
events = requests.get(f"{BASE}/events", params={
"apiKey": KEY, "sport": "football", "league": "england-premier-league", "limit": 10}).json()
ids = ",".join(str(ev["id"]) for ev in events[:10])
# Up to 10 events in one request
odds = requests.get(f"{BASE}/odds/multi", params={
"apiKey": KEY, "eventIds": ids, "bookmakers": "Bet365,Unibet", "markets": "ML"}).json()
for ev in odds:
for book, markets in ev["bookmakers"].items():
ml = next((m for m in markets if m["name"] == "ML"), None)
if ml:
o = ml["odds"][0]
print(ev["home"], "v", ev["away"], book, o["home"], o.get("draw"), o["away"])# pip install odds-api-io
from odds_api import OddsAPIClient
client = OddsAPIClient(api_key="YOUR_API_KEY")
events = client.get_events(sport="football", league="england-premier-league")
odds = client.get_event_odds(event_id=events[0]["id"], bookmakers="Bet365,SingBet,FanDuel"){
"mcpServers": {
"odds-api": {
"command": "npx",
"args": ["-y", "odds-api-mcp-server"],
"env": { "ODDS_API_KEY": "YOUR_API_KEY" }
}
}
}實戰教程:套利投注、價值投注、收盤賠率回測與賠率比較(含程式碼)
下面 4 個示例都只使用官方文件中的介面與欄位;請把 YOUR_API_KEY 換成自己的 Key,並放在環境變數裡。
1. 套利掃描
呼叫 /arbitrage-bets,返回所有腿都在你所選博彩公司內的套利機會,已扣交易所手續費並給出 1000 單位總注額下的最優分配。
import os, requests
r = requests.get("https://api.odds-api.io/v3/arbitrage-bets", params={
"apiKey": os.environ["ODDS_API_KEY"],
"bookmakers": "Bet365,SingBet,Unibet",
"sport": "football", "minProfit": 1, "includeEventDetails": "true"})
r.raise_for_status()
for arb in r.json()[:10]:
ev = arb.get("event", {})
print(f'{arb["profitMargin"]:.2f}% {ev.get("home")} v {ev.get("away")} {arb["market"]["name"]}')
for s in arb["optimalStakes"]: # split of totalStake (1000); scale to your bankroll
print(f' {s["bookmaker"]:<10} {s["side"]:<5} stake {s["stake"]:.2f} -> {s["potentialReturn"]:.2f}')2. 價值投注篩選
/value-bets 返回某家博彩公司高於公允線的報價,EV = 機率 × 賠率 − 1。下面篩出 EV ≥ 3% 的前 10 條。
import os, requests
bets = requests.get("https://api.odds-api.io/v3/value-bets", params={
"apiKey": os.environ["ODDS_API_KEY"], "bookmaker": "Bet365",
"sport": "football", "includeEventDetails": "true"}).json()
top = sorted((b for b in bets if b["expectedValue"] >= 0.03),
key=lambda b: b["expectedValue"], reverse=True)[:10]
for b in top:
side = b["betSide"]
print(f'EV {b["expectedValue"]*100:.1f}% {b["event"]["home"]} v {b["event"]["away"]}'
f' {b["market"]["name"]} {side} @ {b["bookmakerOdds"][side]}')3. 收盤線回測(抽水對比)
/historical/closing-lines 一次取回最多 10 個聯賽、366 天的收盤賠率(付費套餐)。下例計算兩家博彩公司在英超勝平負盤口的平均抽水。
import os, requests, statistics
r = requests.get("https://api.odds-api.io/v3/historical/closing-lines", params={
"apiKey": os.environ["ODDS_API_KEY"], "sport": "football",
"leagues": "england-premier-league",
"from": "2026-01-01T00:00:00Z", "to": "2026-05-31T23:59:59Z",
"markets": "ML", "bookmakers": "Bet365,Unibet", "limit": 100})
margins = {}
for ev in r.json(): # each item is shaped like /historical/odds
for book, markets in ev.get("bookmakers", {}).items():
ml = next((m for m in markets if m["name"] == "ML"), None)
if not ml: continue
o = ml["odds"][0]
overround = sum(1 / float(o[k]) for k in ("home", "draw", "away")) - 1
margins.setdefault(book, []).append(overround)
for book, xs in margins.items():
print(f"{book}: {len(xs)} matches, average closing margin {statistics.mean(xs)*100:.2f}%")
# page through with skip=100, 200, ... for more events4. 最佳價格比價
/odds/summary 直接給出每條盤口線的最佳、平均、中位、最差與去水公允價(Growth 及以上套餐),適合做比價表。
curl -s --compressed "https://api.odds-api.io/v3/odds/summary?apiKey=$ODDS_API_KEY&eventId=123456&markets=ML,Totals"
# per line: best / average / median / worst price and a de-vigged "fair" price延伸閱讀:套利投注是什麼、套利計算器、Python 套利機器人教程、價值投注與收盤線價值(CLV)教程、Bet365 歷史賠率與收盤賠率教程。
SDK、MCP 與 AI 工具
官方提供 Python 與 TypeScript SDK,以及一個 25 個工具的 MCP 伺服器;文件同時釋出 llms.txt、llms-full.txt 與 OpenAPI 規範,方便 AI 程式設計助手使用。
Python SDK
pip install odds-api-io
Node.js / TypeScript
npm i odds-api-io
MCP server
npx -y odds-api-mcp-server
https://docs.odds-api.io/guides/sdks · https://docs.odds-api.io/ai-vibe-coding · https://docs.odds-api.io/llms.txt
賠率 MCP 伺服器可讓 Claude 等 AI 助手直接查詢賠率,官方有用 Claude + MCP 查詢實時賠率的教程;SDK 安裝與用法見官方 SDK 文件。
價格(核對於 2026-11-02)
四個套餐只在可選博彩公司數量上不同,均含 5,000 次請求/小時、全部運動與盤口、賽前與滾球;年付相當於 10 個月價格。
| 項目 | 價格 / 說明 |
|---|---|
| Enterprise | 定製:自選博彩公司數量、不限請求、專用基礎設施、定製資料與 SLA |
| WebSocket 附加項 | 再付一次套餐價(合計 2 倍),如 Solo +£49/月 |
| 請求加購 | 10,000 次/小時 +£139/月 · 20,000 次/小時 +£229/月 · 30,000 次/小時 +£309/月 |
| 計價貨幣 | GBP、USD、EUR、BRL、CNY、JPY、KRW 等本地貨幣顯示 |
| 付款方式 | Visa、Mastercard、Amex、Apple Pay、Google Pay、PayPal;加密貨幣經 CoinGate(10+ 種,年付僅銀行卡) |
| 免費 Key | 新免費 Key 暫停發放;已有免費 Key 100 次/小時、500 次/天 |
新的免費 Key 已暫停發放,詳情見官方免費賠率 API 說明;最新套餐與幣種以Odds-API.io 價格頁為準。
與其他獲取賠率方式的對比
主要有三種方式:自己抓取博彩網站、使用單家博彩公司官方介面(若有)、使用 Odds-API.io 這類聚合 API。聚合 API 的優勢是一次接入多家並已完成賽事匹配。
| 維度 | 自建爬蟲 | 單家博彩公司介面 | Odds-API.io |
|---|---|---|---|
| 接入成本 | 每家單獨開發與維護 | 每家單獨申請與對接 | 一個 Key、一種 JSON |
| 賽事/盤口匹配 | 需自行實現 | 不涉及(僅一家) | 已跨平臺匹配 |
| 覆蓋 | 取決於投入 | 僅該博彩公司 | 450+ 家(含交易所、預測市場) |
| 實時性 | 取決於抓取頻率 | 因平臺而異 | WebSocket 毫秒級推送 |
| 歷史資料 | 需自行積累 | 通常沒有 | 歷史賠率、收盤線、走勢 |
| 費用 | 伺服器與人力 | 因平臺而異 | £49/月起 |
與 The Odds API 的公開資訊對比
下表每一列只引用該服務自己官網在 2026-11-02 顯示的資訊,未做實測。
| 項目 | Odds-API.io(odds-api.io) | The Odds API(the-odds-api.com) |
|---|---|---|
| 計費方式 | 按套餐,固定 5,000 次請求/小時 | 按每月 credits 額度 |
| 入門價格 | Solo £49/月(2 家博彩公司) | 免費 500 credits/月;付費 $30/月(20K credits)起 |
| 更高檔 | £99 / £179 / £229 每月 | $59(100K)/ $119(5M)/ $249(15M)每月 |
| 覆蓋(官網自述) | 450+ 博彩公司、34 運動、12,000+ 聯賽 | 100+ 運動、100+ 博彩公司 |
| 實時推送 | WebSocket(付費附加項) | 官網首頁未提及 |
| 其他 | MCP 伺服器、Python/TS SDK、套利/價值介面 | Google Sheets 與 Excel 外掛;十進位制與美式賠率 |
https://odds-api.io/pricing · https://the-odds-api.com/
官方也釋出了The Odds API 替代方案對比、OpticOdds 對比、BetsAPI 對比和Pinnacle API 停用後的替代資料來源(這些對比為 odds-api.io 自述)。
術語表
理解賠率資料常用的 14 個術語。
- 十進位制賠率 Decimal odds
- 每 1 單位注額的總返還(含本金)。odds-api.io 的賠率以字串形式的十進位制價格返回,例如 "2.10"。
- 隱含機率 Implied probability
- 1 ÷ 十進位制賠率。2.00 對應 50%。
- 抽水 / 利潤率 Overround (vig)
- 同一盤口所有結果隱含機率之和超出 100% 的部分,即博彩公司的利潤空間。
- 去水 / 公允價 De-vig / fair price
- 把隱含機率按比例縮放到總和 100%,得到不含抽水的公允機率與價格。/odds/summary 的 fair 欄位即基於去水機率中位數。
- 期望值 EV
- 官方文件定義:EV = 機率 × 賠率 − 1,正值即價值投注。
- 套利 Arbitrage (surebet)
- 各結果最佳價格的隱含機率合計低於 100%,按比例下注可鎖定收益。/arbitrage-bets 的 impliedProbability < 1。
- 收盤線 Closing line
- 開賽前最後的價格,常被視為最有效的市場價格。
- CLV 收盤線價值
- 你的成交價與收盤價之差,用來衡量下注時機是否優於市場。
- 銳盤 Sharp book
- 接受大額注單、價格發現領先的博彩公司;軟盤(soft book)則相反。
- 交易所 Exchange
- 使用者之間互相下注(back/lay)的平臺,如 Betfair Exchange,平臺收取佣金。
- 跌水 Dropping odds
- 價格快速下降,通常反映資金或資訊流入;/dropping-odds 按開盤、12h、24h、48h 計算跌幅。
- 亞洲讓球 Asian handicap
- 去除平局的讓球盤,含 0.25 等四分之一線;在 odds-api.io 中歸入 Spread 盤口。
- 球員道具 Player props
- 針對單個球員表現的盤口,如射門、助攻、得分。
- 滾球 In-play / live
- 比賽進行中的投注盤口,價格變化很快,適合用 WebSocket 獲取。
更多術語與工具:隱含機率、價值投注定義、亞洲盤(讓球)、賠率轉換器、抽水(margin)計算器。
常見問題
關於 Odds-API.io 的 18 個常見問題,答案均來自官網與官方文件。
Odds-API.io 是什麼?
一個體育博彩賠率資料 API,把 450+ 家博彩公司的賽前、滾球和歷史賠率統一成一種 JSON 結構,透過 REST、WebSocket 或 MCP 提供。
可以免費試用嗎?
新的免費 Key 目前已暫停(已有免費 Key 仍可用,限 100 次/小時、500 次/天)。最便宜的是 Solo £49/月,可隨時取消。/sports、/bookmakers、/markets 不需要 Key。
各套餐有什麼區別?
只在可選博彩公司數量上不同:Solo 2、Starter 5、Growth 10、Pro 15。都含 5,000 次請求/小時、全部運動和盤口、賽前與滾球。/odds/summary 需要 Growth 及以上。
WebSocket 怎麼收費?
WebSocket 是附加項,價格等於套餐價本身,合計為套餐價的 2 倍,例如 Solo 額外 +£49/月。
請求次數有上限嗎?
每個套餐 5,000 次請求/小時,沒有月度上限;可加購到 10,000(+£139/月)、20,000(+£229/月)、30,000(+£309/月)次每小時。
覆蓋哪些運動?
34 個運動,包括足球、籃球、網球、美式足球、冰球、棒球、板球、電競(CS2、英雄聯盟、Dota 2、Valorant 等)、飛鏢、斯諾克、高爾夫等。
有 Bet365 賠率嗎?
有。Bet365 賽前與滾球賠率、球員道具、角球和罰牌;官網說明 Bet365 沒有公開 API。截至 2026-11-02,Bet365 頁面顯示 16 個運動、190 個盤口。
有滾球賠率嗎?
有。大部分博彩公司同時覆蓋賽前與滾球,並附帶比分、比賽時鐘和狀態。
REST 和 WebSocket 選哪個?
官方推薦大多數應用用 WebSocket(延遲最低、頻寬更省);REST 適合腳本、快速查詢與回填。文件建議賽前賠率快取 30–60 秒,賽事列表 5–10 分鐘。
有歷史賠率可以回測嗎?
有:/historical/events、/historical/odds、/historical/closing-lines(付費,單次最多 10 個聯賽、366 天)以及 /odds/movements。
套利介面怎麼用?
GET /arbitrage-bets 傳入你的博彩公司列表,返回各腿都在這些博彩公司內的套利機會,按 profitMargin 排序;利潤率已扣除交易所手續費,注額遵守博彩公司報告的限額。僅賽前,每幾秒重新整理。
可以商用或展示給使用者嗎?
可以在自己的網站、應用或工具(含付費產品)中展示;轉售或再分發原始資料需要企業協議。
博彩公司選好後能換嗎?
可以。訂閱後在控制檯選擇並可更換,API Key 不變;也可以用 PUT /bookmakers/selected/select 介面選擇。
支援預測市場嗎?
支援 Polymarket 與 Kalshi 等;/mappings 可把賠率對映到 Polymarket conditionId/CLOB token id 或 Kalshi 合約 ticker(付費套餐)。
能和 AI 助手一起用嗎?
可以。官方 MCP 伺服器(npm 包 odds-api-mcp-server)為 Claude、Codex、Cursor 提供 25 個工具;文件還有 llms.txt、llms-full.txt 和 OpenAPI 規範。
可以用加密貨幣付款嗎?
可以,結賬選 Crypto,支援 BTC、ETH、USDC、TRX、SOL、LTC 等 10+ 種幣,由 CoinGate 處理;續費以帶付款連結的發票形式傳送。
API Key 怎麼傳?安全嗎?
以查詢參數 apiKey 傳入。官方建議放在環境變數中、只在後端呼叫,不要暴露在前端程式碼裡。
遇到 429 怎麼辦?
429 表示超出限流。每個響應都帶 x-ratelimit-limit / remaining / reset 頭;官方建議指數退避,並用 /odds/multi(10 場計 1 次)減少請求。
合作伙伴計劃
odds-api.io 的合作伙伴計劃為推薦使用者支付 30% 終身迴圈佣金,被推薦使用者前 3 個月享 30% 折扣,Cookie 有效期 90 天,每月透過 Dub 以銀行轉賬或 USDC 結算。
資料來源
本頁所有數字與說明的來源(訪問日期 2026-11-02):
- odds-api.io 首頁: https://odds-api.io/
- 價格頁: https://odds-api.io/pricing
- 博彩公司列表: https://odds-api.io/sportsbooks
- Bet365 頁面: https://odds-api.io/sportsbooks/bet365
- 合作伙伴計劃: https://odds-api.io/partners
- 官方文件: https://docs.odds-api.io/
- Quickstart: https://docs.odds-api.io/quickstart
- SDK 指南: https://docs.odds-api.io/guides/sdks
- WebSocket 指南: https://docs.odds-api.io/guides/websockets
- AI 程式設計指南: https://docs.odds-api.io/ai-vibe-coding
- 更新日誌: https://docs.odds-api.io/changelog
- llms-full.txt: https://docs.odds-api.io/llms-full.txt
- The Odds API 首頁(對比用): https://the-odds-api.com/