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]}。

常见问题