Odds-API.io 實戰案例：從 API 金鑰到 AI 代理市場分析，以及下注這一步要注意什麼

第 1 步：如何取得 Odds-API.io API 金鑰？

截至 2026 年 11 月 2 日，Odds-API.io 表示新的免費 API 金鑰已無限期暫停發放；暫停前發出的免費金鑰仍可使用，若恢復發放將在更新日誌公告 ^[1]。目前取得金鑰的流程：

1. 在 Odds-API.io 價格頁 合作連結選擇方案，入門方案為 Solo（每月 £49）^[2]。
2. 以信用卡、Apple Pay、Google Pay 或 PayPal 付款；月付方案也可用 10 多種加密貨幣支付，年付僅限信用卡 ^[2]。
3. 查收電郵：文件說明金鑰會寄到註冊信箱；MCP 頁面也表示付款完成後可在控制台看到金鑰 ^{[6] [3]}。
4. 在控制台選擇博彩公司（數量依方案而定），之後可用同一把金鑰更換 ^[2]。
5. 妥善保管金鑰：文件提醒不要提交到版本控制，應存放在 ODDS_API_KEY 等環境變數中 ^[6]。

付款前可以先試：GET https://api.odds-api.io/v3/sports 不需要金鑰 ^[6]：

curl "https://api.odds-api.io/v3/sports"
# → [{"name": "Football", "slug": "football"}, {"name": "Basketball", "slug": "basketball"}, ...]

推薦折扣：根據 Odds-API.io 合作夥伴頁面，透過合作夥伴連結註冊的客戶前 3 個月可享 7 折（30% off）；價格頁 FAQ 補充，促銷碼與推薦折扣僅適用於月付方案。付款前請以結帳頁顯示的最終價格為準 ^{[7] [2]}。

選擇方案並取得金鑰 → 合作連結

第 2 步：Odds-API.io 免費與付費方案有什麼差別？

付費方案之間只差在可選的博彩公司數量，請求次數、運動與盤口完全相同；免費方案則另成一類：請求額度低得多、只限休閒型博彩公司，而且不再開放新用戶 ^{[2] [1]}。

選擇方案

合作連結 — 我們可能因此獲得佣金，詳見聯盟行銷揭露。

以上為 2026 年 11 月 2 日官網公布價格 ^{[2] [1]}。

• 年付為月費的 10 倍（等於送兩個月），僅限信用卡，且不能搭配額外請求套餐 ^[2]。
• WebSocket 串流是加購項目，價格等於再付一次方案費（共 2 倍），例如 Solo + WebSocket 為每月 £98；官方推薦用於最低延遲 ^[2]。
• 更多請求：可提升至每小時 10,000 次（每月 +£139）、20,000 次（+£229）或 30,000 次（+£309）^[2]。
• 幣別：標價為英鎊，結帳時以當地貨幣收費（GBP、USD、EUR、BRL、CNY、JPY、KRW）^[2]。
• 僅限付費的功能：文件註明原生 ID 對照（Polymarket／Kalshi ID）與 dropping odds 僅限付費方案 ^{[8] [9]}。

本案例該選哪個方案？若要比較 1 家博彩公司與 Polymarket、Kalshi，需要 3 家 → Starter（5 家）；若是 2 家博彩公司加兩個預測市場共 4 家，仍是 Starter。Solo 只適合兩個來源的比較。

比較 Odds-API.io 方案 → 合作連結

第 3 步：如何讓 AI 代理取得 Odds-API.io 資料？

有兩種方式：提供文件讓代理撰寫 REST 程式，或透過官方 MCP 伺服器提供即時工具。Odds-API.io 指出多數人兩者並用 ^{[3] [9]}。

方式 A：官方 MCP 伺服器（Claude、Codex、Cursor、VS Code）

伺服器為 npm 套件 odds-api-mcp-server，MIT 授權開源；它在你的電腦上以 stdio 執行，金鑰只會傳送到 api.odds-api.io，每次工具呼叫都是一般 API 請求，計入每小時 5,000 次額度 ^[3]。

# Claude Code
claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

# Codex CLI
codex mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

Claude Desktop（claude_desktop_config.json）或 Cursor（.cursor/mcp.json）加入以下設定 ^[9]：

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": { "ODDS_API_KEY": "your-api-key" }
    }
  }
}

VS Code 使用 .vscode/mcp.json，頂層鍵為 "servers"；另有 Docker 映像（oddsapi/odds-api-mcp-server）與 Claude Desktop 一鍵安裝的 .mcpb 檔 ^[3]。

25 個工具包括 get_events、search_events、get_odds、get_multi_odds、get_odds_movements、get_value_bets、get_arbitrage_bets、get_historical_odds 與 grade_bets。此伺服器只讀取資料，無法登入博彩公司或下注 ^[3]。

ChatGPT 怎麼辦？

ChatGPT 只能透過 SSE 或串流 HTTP 連接遠端 MCP 伺服器，無法直接啟動像 odds-api-mcp-server 這樣的本機 stdio 伺服器；本機或私有伺服器需使用 OpenAI 的 Secure MCP Tunnel ^[10]。在 ChatGPT 中較簡單的做法是文件路線：Odds-API.io 建議請它讀取 https://docs.odds-api.io/llms-full.txt，或貼上官方提供的上下文區塊 ^[9]。若想在 OpenAI 產品中使用 MCP 工具，可用上方的 Codex CLI 指令（官方支援）。

方式 B：由代理撰寫 REST 程式（Python／TypeScript）

基礎網址 https://api.odds-api.io/v3，金鑰以查詢參數 apiKey 傳遞 ^[9]。官方 SDK：pip install odds-api-io、npm install odds-api-io ^[11]。

# Python — official SDK (pip install odds-api-io)
import os
from odds_api import OddsAPIClient

client = OddsAPIClient(api_key=os.environ["ODDS_API_KEY"])
events = client.get_events(sport="football", league="england-premier-league")
odds = client.get_event_odds(event_id=events[0]["id"],
                             bookmakers="Bet365,Polymarket,Kalshi")
for bookie, markets in odds["bookmakers"].items():
    ml = next((m for m in markets if m["name"] == "ML"), None)
    if ml:
        o = ml["odds"][0]
        print(bookie, o["home"], o.get("draw"), o["away"])
print(odds.get("urls", {}))   # direct links to the event at each bookmaker

// TypeScript — official SDK (npm install odds-api-io)
import { OddsAPIClient } from "odds-api-io";

const client = new OddsAPIClient({ apiKey: process.env.ODDS_API_KEY! });
const events = await client.getEvents({ sport: "football", league: "england-premier-league" });
const odds = await client.getEventOdds({ eventId: events[0].id, bookmakers: "Bet365,Polymarket,Kalshi" });
for (const [bookie, markets] of Object.entries(odds.bookmakers)) {
  const ml = markets.find((m) => m.name === "ML");
  if (ml?.odds?.[0]) console.log(bookie, ml.odds[0].home, ml.odds[0].draw, ml.odds[0].away);
}

Odds-API.io MCP 頁面上的範例提問：「這個週末哪些英超比賽在 Bet365 與 Unibet 的獨贏盤差距最大？」代理會以 get_events 加 get_multi_odds 回答 ^[3]。

取得 MCP 伺服器用的金鑰 → 合作連結

第 4 步：實戰案例：如何在博彩公司與預測市場之間分析同一場比賽？

示意用範例資料。下方 Polymarket 與 Kalshi 價格取自 Odds-API.io 預測市場指南中的範例值（Leeds United 對 Arsenal，獨贏盤）^[12]；兩列博彩公司資料為虛構示意。以下皆非即時價格，也不是結果、推薦或獲利。

4.1 資料結構

GET /v3/odds?eventId=…&bookmakers=Polymarket,Kalshi,Bet365,Unibet 每場賽事回傳一個物件：bookmakers 盤口對照、urls（各博彩公司的賽事連結），預測市場還有 bookmakerIds、back／lay 價格與以美元計的深度 ^{[12] [6]}：

"Polymarket": [{ "name": "ML", "odds": [{ "home": "6.67", "draw": "4.35", "away": "1.56",
  "layHome": "1.61", "layAway": "7.14", "layDraw": "4.55",
  "depthHome": "12128", "depthAway": "331", "depthDraw": "26086" }] }]

4.2 隱含機率與抽水（overround）

隱含機率 = 1 ÷ 小數賠率；預測市場以美分報價，60¢ 即 60%，等於賠率 1.67 ^[12]。三個結果加總即可看出各來源的抽水：

4.3 去水（公平機率）

最簡單的方法是把每個隱含機率除以總和：博彩公司 A 的 16.7／23.8／65.4（總和 105.8）約變為 15.7%／22.5%／61.8%，即公平賠率約 6.35／4.45／1.62。比例去水只是其中一種方法；Odds-API.io 自家的價值投注引擎則以一組 sharp 博彩公司的共識計算公平賠率，因為休閒型博彩公司的抽水會扭曲基準 ^[13]。

4.4 比價（line shopping）

四個來源中各結果的最佳價格：主勝 6.67（Polymarket）、和局 4.35、客勝 1.56（Polymarket／Kalshi）。三者隱含機率加總 102.1%，高於 100%，因此這場示意比賽沒有套利空間——Odds-API.io 的定義要求最佳價格加總低於 100% ^[14]。

4.5 博彩公司對預測市場：有沒有「價值」？

若以兩家示意博彩公司去水後機率的平均值作為暫代的公平線（主勝約 15.5%），Polymarket 主勝 6.67 的 EV = 0.155 × 6.67 − 1 ≈ +3%（文件公式：EV = 公平機率 × 賠率 − 1）^[13]。實際上這個數字可能縮小甚至消失，原因是：

• 基準只是兩個虛構的休閒型價格，而非 sharp 共識 ^[13]；
• Polymarket 與 Kalshi 收取手續費，Odds-API.io 套利引擎以 netOdds 計入 ^{[14] [15] [16]}；
• 深度很重要：文件提醒流動性很少的價格無法承接有意義的金額 ^[12]；
• 從快照到下單之間價格會變動；文件明言價值投注是理論值，並非每注都會贏 ^[13]。

# Python: de-vig, line shopping and EV on an /v3/odds response (illustrative)
def implied(o): return 1 / float(o)

def devig(prices):                       # prices = {"home": "6.00", "draw": "4.20", "away": "1.53"}
    p = {k: implied(v) for k, v in prices.items() if k in ("home", "draw", "away")}
    total = sum(p.values())
    return {k: v / total for k, v in p.items()}, total - 1   # fair probs, overround

def best_prices(event):
    best = {}
    for book, markets in event["bookmakers"].items():
        ml = next((m for m in markets if m["name"] == "ML"), None)
        if not ml: continue
        for side in ("home", "draw", "away"):
            price = float(ml["odds"][0][side])
            if side not in best or price > best[side][0]:
                best[side] = (price, book, event.get("urls", {}).get(book))
    return best

def ev(fair_prob, odds): return fair_prob * float(odds) - 1   # docs formula

4.6 交給 API：/value-bets 與 /arbitrage-bets

Odds-API.io 也會直接幫你算：/v3/value-bets?bookmaker=… 回傳 expectedValue、betSide 與 bookmakerOdds.href（下注連結），每 5 秒重新計算 ^[13]；/v3/arbitrage-bets?bookmakers=… 回傳 profitMargin、legs[]（已知時含 netOdds 與 maxStake）及 optimalStakes[]，僅限賽前，且利潤率是「以報價計算的結果，並非保證回報」^[14]。

文件說明：REST 指南範例中的 expectedValue 為小數（0.0523 = 5.23%），但某個 SDK 範例卻將其減 100，像是百分比格式。設定門檻前請先檢查實際回應 ^{[13] [11]}。

用自己的 Odds-API.io 金鑰跑這套分析 → 合作連結

第 5 步：分析完之後，如何在不同平台下注？

Odds-API.io 是資料服務，API 與 MCP 伺服器都不會下注 ^[3]。接下來怎麼做取決於平台，也取決於對你而言是否合法。

博彩公司（如 bet365）：透過深層連結手動下注

回應中附有各博彩公司的賽事連結：/v3/odds 的 urls、價值投注的 bookmakerOdds.href、套利的 legs[].href（未知時為 "N/A"）^{[6] [13] [14]}。開啟連結、登入你合法持有的帳戶，確認價格仍在再下注。不要自動化這一步：bet365 一般條款（2026-09-28 生效）將套利（§16.2(e)）、使用 VPN 隱藏位置（§16.2(k)）、爬取資料（§16.2(w)）以及「人工智慧、自動玩家（機器人）及／或玩家輔助軟體」（§16.2(z)）列為「禁止行為」，並可將其認為由自動系統下的注作廢（§14.5(c)）^[17]。Odds-API.io 本身也提醒，經常找到價值的帳戶可能被博彩公司限制 ^[13]。

Polymarket（國際版）：官方 SDK，並有地區封鎖

以 /v3/mappings?bookmaker=Polymarket 將 Odds-API.io 的選項對應到 Polymarket 的 conditionId 與 CLOB token id（付費方案）^[8]，再使用 Polymarket 官方 SDK（pip install polymarket-client 或 npm install @polymarket/client）^[18]：

# Polymarket docs pattern (Python, async)
from polymarket import AsyncSecureClient
client = await AsyncSecureClient.create(private_key=os.environ["POLYMARKET_PRIVATE_KEY"],
                                        wallet=os.environ["POLYMARKET_WALLET_ADDRESS"])
response = await client.place_market_order(asset_id=asset_id, side="BUY", amount="10")  # spend up to 10 pUSD

Polymarket 表示來自封鎖地區的訂單會被拒絕，並要求開發者先檢查 GET https://polymarket.com/api/geoblock；其清單將美國、英國、法國、德國、義大利、台灣、新加坡、澳洲等列為只能平倉（close-only）^{[4] [19]}。其說明中心指出用 VPN 規避屬違反條款 ^[20]。美國用戶另有受 CFTC 監管的 Polymarket US ^[21]。

Kalshi：簽章 API 請求，先用 demo 環境

以 /v3/mappings?bookmaker=Kalshi 取得合約 ticker 與 yes／no ^[8]。Kalshi API 請求須帶 KALSHI-ACCESS-KEY、KALSHI-ACCESS-TIMESTAMP、KALSHI-ACCESS-SIGNATURE 標頭（以私鑰對 timestamp + method + path 簽章）^[22]；下單為 POST 到 /portfolio/events/orders，請先在 demo 環境（external-api.demo.kalshi.co）測試 ^{[23] [24]}。

# Kalshi docs pattern (demo): 1 YES contract, limit order
order = {"ticker": market_ticker, "side": "bid", "count": "1", "price": "0.0100",
         "time_in_force": "good_till_canceled", "client_order_id": str(uuid.uuid4())}
r = post(private_key, API_KEY_ID, "/portfolio/events/orders", order)   # signed POST, see Kalshi auth guide

Kalshi 要求用戶年滿 18 歲，並可能要求身分證件 ^[25]。其 2026 年 6 月 22 日交易所公告禁止受限地區交易事件合約，包括英國、加拿大、澳洲、法國、義大利、愛爾蘭、波蘭、葡萄牙、瑞士、台灣、新加坡、泰國與中華人民共和國 ^[5]。在美國，Kalshi 的體育合約仍在州與聯邦法院爭訟中 ^[26]。

在你所在地合法嗎？

事件合約同樣適用內線交易規範，CFTC 已有執法案例 ^{[33] [34]}。

常見問題