关键事实(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 个月价格。
Solo
- 2 家博彩公司
- 5,000 次请求/小时
- 全部运动与盘口
- 赛前 + 滚球
- 邮件支持
Starter
- 5 家博彩公司
- 5,000 次请求/小时
- 全部运动与盘口
- 赛前 + 滚球
- 邮件支持
Growth
- 10 家博彩公司
- 5,000 次请求/小时
- 全部运动与盘口
- 赛前 + 滚球
- 优先支持
Pro
- 15 家博彩公司
- 5,000 次请求/小时
- 全部运动与盘口
- 赛前 + 滚球
- 专属支持
| 项目 | 价格 / 说明 |
|---|---|
| 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/