博彩套利的体育赔率 API:通过 API 获取赛事、赔率和 surebet
简而言之
- 体育赔率 API 返回赛事、市场以及每家博彩公司的赔率,并附带最近一次更新的时间。十进制赔率的隐含概率是 1/k,预测市场中 YES 合约的美元价格就是同一个概率。
- 当一个市场所有结果的最优赔率之 1/k 相加小于 1 时,就存在 surebet,每笔投注额与 1/k 成正比。多数错误出在匹配上:每个平台上的比赛、市场、时段和盘口线必须一致。
- 在 Pro 和 Max 套餐中使用
mode=sport,Genesis API 会返回 13 个平台的赛前 surebet,并为每条腿给出stake_unit。由于博彩公司的投注限额未知,其profit_usd为 null。
体育赔率 API,也叫体育博彩 API,让程序可以获取盘口数据:赛事、市场以及每家博彩公司的赔率,并附带每个价格最近一次更新的时间。程序据此比较各平台的价格,找出 surebet——对一场比赛的所有结果都下注,无论结果如何都能盈利,前提是每笔投注都按相同规则被接受并结算。这就是博彩套利,Genesis API 通过带 mode=sport 的 /predictions/arbitrage endpoint 提供 13 个平台的现成 surebet。
体育赔率 API 返回什么
各家服务商对字段的命名不同,但赔率 API 都从五个层级描述盘口。没有时段和盘口线,两个赔率无法比较;没有时间,就无法判断价格是否仍然有效。右列是示例说明。
| 层级 | 内容 | 示例 |
|---|---|---|
| 赛事 | 项目、赛事联赛、球队、开赛时间 | 足球,德甲,Bayern — Dortmund |
| 市场 | 投注类型、时段、盘口线 | 总进球 2.5,常规时间 |
| 结果 | 投注的选项 | 大 2.5 |
| 价格 | 每家博彩公司的赔率 | Fonbet @1.95,Winline @2.02 |
| 时间 | 价格更新的时间 | 12 秒前 |
赔率有十进制、分数和美式三种格式,而预测平台报的是以美元计的合约价格,不是赔率。数据来自平台自己的开放 API,或来自把多家博彩公司的盘口汇总成统一格式的服务商。Polymarket 和 Kalshi 的数据见 Polymarket 与 Kalshi API 一文。
赔率、概率与以美分计的价格
十进制赔率表示每投注 1 美元能收回多少(含本金):$100 按 @2.25 变成 $225。它的倒数就是隐含概率:1 / 2.25 = 0.4444,即 44.44%。分数赔率和美式赔率可按 博彩赔率详解 中的公式换算成十进制。
| 价格 | 十进制赔率 | 概率 |
|---|---|---|
| 博彩公司 @2.25 | 2.25 | 44.44% |
| 博彩公司 @3.60 | 3.60 | 27.78% |
| Polymarket 上 30¢ 的 YES | 1 / 0.30 = 3.33 | 30% |
YES 合约在其结果发生时支付 $1,所以它的美元价格就是市场对概率的估计。“Bayern 获胜”的 NO 合约在 Dortmund 获胜或平局时盈利,类似双重机会。
在单一博彩公司中,一个市场所有结果的概率之和大于 1,多出的部分就是它的抽水。示例说明:Fonbet 对 Bayern — Dortmund 的盘口 2.15 / 3.45 / 3.40,得到 0.46512 + 0.28986 + 0.29412 = 1.04910,抽水为 4.91%。分步计算见 如何计算博彩公司抽水。
如何从赔率中找到 surebet
surebet 要从各博彩公司的最优价格中找:对市场的每个结果取最高赔率,再把各个 1/k 相加。示例说明:同一场比赛,常规时间的胜平负市场。
| 结果 | 最优赔率 | 来源 | 1/k |
|---|---|---|---|
| 1,Bayern 胜 | @2.25 | Betcity | 0.44444 |
| X,平局 | @3.60 | Marathon | 0.27778 |
| 2,Dortmund 胜 | @3.80 | Winline | 0.26316 |
L = 0.44444 + 0.27778 + 0.26316 = 0.98538
总和小于 1,所以存在 surebet,利润为 1 / 0.98538 − 1 = 1.48%。下面代码中四家博彩公司各自盘口的抽水在 3.8% 到 5.1% 之间;surebet 来自它们对这场比赛定价的差异。
总投注额按 1/k 成比例分配:$1,000 中,主胜投注为 1,000 × 0.44444 / 0.98538 = $451.04,其余投注额见表。
| 投注 | 投注额 | 若获胜 |
|---|---|---|
| Betcity · 1 @2.25 | $451.04 | $1,014.84 |
| Marathon · X @3.60 | $281.90 | $1,014.84 |
| Winline · 2 @3.80 | $267.06 | $1,014.83 |
每个结果大约都返还 1,000 / 0.98538 = $1,014.84;由于投注额取整,最坏情况下的利润为 $14.83。
同样的逻辑用代码表示,输入是四家博彩公司对同一个市场的盘口:
# 示例说明:四家博彩公司对同一个 1X2 市场的盘口
line = {
"Fonbet": {"1": 2.15, "X": 3.45, "2": 3.40},
"Betcity": {"1": 2.25, "X": 3.20, "2": 3.40},
"Marathon": {"1": 2.05, "X": 3.60, "2": 3.50},
"Winline": {"1": 2.10, "X": 3.35, "2": 3.80},
}
def surebet(line, bank):
outcomes = next(iter(line.values())).keys()
# 每个结果的最优赔率及提供该赔率的博彩公司
best = {o: max((odds[o], bk) for bk, odds in line.items())
for o in outcomes}
total = sum(1 / k for k, _ in best.values())
if total >= 1:
return None # 没有 surebet
for o, (k, bk) in best.items():
print(f"{o}: {bk} @{k} — ${bank / k / total:.2f}")
return round((1 / total - 1) * 100, 2)
print(surebet(line, 1000), "%") # 1.48 %
双向市场——让球、大小球、双方进球——在字典里只有两个键,公式不变。投注额取整以及赔率变动后的重新计算,见课程 如何计算 surebet。
匹配:同一场比赛、市场、时段和盘口线
只有当每个价格都属于同一场比赛的同一个市场时,公式才成立。各博彩公司对球队名称的写法不同,开赛时间相差几分钟,市场也各有名称。匹配错误会产生虚假的 surebet:1/k 之和小于 1,但在其中一个结果上所有投注都会输。
| 检查什么 | 容易出错的地方 | mode=sport 中的字段 |
|---|---|---|
| 比赛和阵容 | Bayern 对 Bayern II,女足或青年队 | teams、flags |
| 开赛时间 | 某家博彩公司的比赛改期 | starts_at |
| 市场类型 | 胜平负、让球、大小球、BTTS、正确比分 | market_type |
| 时段 | 常规时间,还是含加时的比赛 | period |
| 盘口线 | 让球 −1.5 和 −1.25 是不同的投注 | line |
| 各条腿的结果 | 各条腿合起来必须覆盖所有结果 | legs[].covers |
足球的常规时间是 90 分钟加伤停补时。除非市场名称注明包含加时和点球,投注平台通常按常规时间结算足球和冰球的比赛结果、让球和大小球。预测平台上的获胜者市场可能包含加时,此时常规时间的平局可能让整组投注全部亏损。
让球与大小相同的反向让球配对成 surebet:主队 −1.5 和客队 +1.5。对于 −0.75 这类四分之一的亚洲让球,投注额一分为二押在相邻的两条盘口线上,主队 −0.75 与客队 +0.75 同样覆盖所有比分。大小球在同一条盘口线上配对:大 2.5 与小 2.5。
反过来的组合,大 2.5 与小 3.5,是对冲夹击(middle):进 3 球时两笔投注都赢。在 Genesis API 中,line 和 period 对整个 surebet 只设置一次,所以盘口线不同的腿不会出现在同一行。
通过 Genesis API 获取 surebet:mode=sport
带 mode=sport 的 /predictions/arbitrage endpoint 返回已经做完上述工作的 surebet:赛事在各平台间完成匹配,选出最优价格,预测平台的腿则按订单簿逐档计算并计入手续费。共有 13 个平台:Polymarket、Kalshi、Predict.fun,以及 10 个博彩平台——Fonbet、Betcity、Olimpbet、Marathon、5051X、Melbet、Winline、BC.Game、EGB 和 Dafa Sports。仅限赛前:比赛一开始,它的 surebet 就会从响应中消失。
该模式属于 Pro(每月 $100,每 10 秒一份新快照)和 Max($200,每 5 秒一份)套餐;在 Trial 和 Start 上,请求会返回 403 plan_restricted。API 不返回每家博彩公司的完整盘口:响应中只有找到的 surebet,以及每条腿的平台、结果和价格。
curl -G "https://api.genesisarbitrage.com/v1/predictions/arbitrage" \
-H "X-API-Key: gns_live_XXXXXXXXXXXXXXXX" \
-d mode=sport -d sport=soccer -d min_profit_pct=1.5
示例说明:文档中重新计算过价格的一行 mode=sport 数据:
{
"id": "s:8812:FT:TOT:2.5:",
"kind": "sport",
"match": "sport",
"title": "Arsenal — Chelsea",
"category": "sports",
"sport": "soccer",
"league": "Premier League",
"teams": ["Arsenal", "Chelsea"],
"market_type": "TOT",
"period": "RT",
"line": 2.5,
"score": null,
"starts_at": 1794700800,
"size_usd": 1000,
"profit_usd": null,
"profit_pct": 2.39,
"legs": [
{
"platform": "polymarket",
"side": "yes",
"outcome": "Over 2.5",
"covers": ["O"],
"price_avg": 0.505,
"odds": null,
"stake_unit": 0.505,
"currency": "USD"
},
{
"platform": "fonbet",
"side": "bet",
"outcome": "Under 2.5",
"covers": ["U"],
"odds": 2.12,
"stake_unit": 0.471698,
"currency": "RUB"
}
]
}
盘口的五个层级与该行的字段对应如下:
| 层级 | 字段 | 示例中 |
|---|---|---|
| 赛事 | title、sport、league、teams、starts_at | Arsenal — Chelsea,soccer,Premier League |
| 市场 | market_type、period、line、score | TOT、FT、2.5 |
| 腿 | platform、side、outcome、covers | fonbet、bet、小 2.5、U |
| 价格 | odds、price_avg、stake_unit、currency | 2.12、0.471698、RUB |
| 结果 | size_usd、profit_pct、profit_usd | 1000、2.39、null |
market_type 是市场:WIN 为比赛结果,HCP 为让球,TOT 为大小球,BTTS 为双方进球,CS 为正确比分,比分写在 score 中。side 对买入合约取 yes 或 no,对按赔率的投注取 bet。covers 列出一条腿覆盖的结果:这里 O 是大,U 是小。
如何按 stake_unit 分配投注额
stake_unit 是一条腿若获胜要返还 $1 时应押的金额。对按赔率的投注,它等于 1 / odds:1 / 2.12 = 0.471698。对 YES 或 NO 的买入,它是含手续费的订单簿平均价格;示例说明里没有手续费,所以 stake_unit 等于 price_avg。
各单位之和为 0.505 + 0.471698 = 0.976698,因此利润为 1 / 0.976698 − 1 = 2.39%。用 surebet 公式分配你自己的金额 S:每条腿的投注额 = S × stake_unit / Σ stake_unit。以 $500 为例:
| 腿 | 投注额 | 若获胜 |
|---|---|---|
| Polymarket · YES “Over 2.5”,50.5¢ | $258.52 | 511.92 份——$511.92 |
| Fonbet · 小 2.5 @2.12 | $241.48 | $511.94 |
两个结果都大约返还 $511.93,最坏情况下利润为 $11.92。size_usd 是预测平台订单簿在这些价格上能承接的金额。这里是 $1,000:1,000 / 0.505 ≈ 1,980.2 份,所以如果博彩公司接受,Fonbet 的投注最多可到 1,980.2 × 0.471698 ≈ $934.06。
profit_usd 为 null,是因为以美元计的利润取决于 Fonbet 接受多少,而博彩公司不公布它的投注限额。因此 min_profit_usd 过滤器会剔除所有含博彩公司腿的 surebet——请改用 min_profit_pct 过滤。
Fonbet 的投注以卢布计(currency = RUB)。按示例说明用的汇率 80 ₽ 兑 $1,即 241.48 × 80 = 19,318.40 ₽,小 2.5 返还 19,318.40 × 2.12 = 40,955.01 ₽。换汇时的汇差不计入 profit_pct。
Python:用 min_profit_pct 获取足球 surebet
脚本请求利润不低于 1.5% 的足球 surebet,打印每一条及距开赛的时间,并按 stake_unit 把 BANK 金额分配到各条腿。密钥取自环境变量 GENESIS_API_KEY;获取方法见快速开始。
import os
import time
import requests
API = "https://api.genesisarbitrage.com/v1"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
PARAMS = {"mode": "sport", "sport": "soccer", "min_profit_pct": 1.5}
BANK = 500 # 整个 surebet 的总投注额,$
def fetch():
while True:
r = requests.get(f"{API}/predictions/arbitrage",
headers=HEADERS, params=PARAMS, timeout=10)
if r.status_code in (429, 503):
time.sleep(int(r.headers.get("Retry-After", "5")))
continue
if r.status_code == 403:
raise SystemExit("mode=sport 需要 Pro 或 Max 套餐")
r.raise_for_status()
return r.json()["data"]
def unit(leg): # 赢 $1 所需的投注:stake_unit,否则取 1/odds 或价格
if leg.get("stake_unit"):
return leg["stake_unit"]
return 1 / leg["odds"] if leg.get("odds") else leg["price_avg"]
for row in fetch():
mkt = [row["market_type"], row["line"], row["period"]]
mkt = " ".join(str(v) for v in mkt if v is not None)
hours = (row["starts_at"] - time.time()) / 3600
print(f"{row['profit_pct']}% · {row['title']} · {mkt} · "
f"距开赛 {hours:.1f} 小时")
total = sum(unit(leg) for leg in row["legs"])
for leg in row["legs"]:
price = leg.get("odds") or leg.get("price_avg")
print(f" {leg['platform']}: {leg['outcome']} at {price} — "
f"${BANK * unit(leg) / total:.2f} ({leg['currency']})")
每条腿的金额以美元打印,旁边是该平台的货币:卢布投注请按你自己的汇率换算。如果某条腿没有 stake_unit,unit 会退回到不含手续费的 1 / odds 或 price_avg,所以算出的利润会比实际略高。
要跟踪新的 surebet,请每隔 meta.freshness_sec 重复请求并比较 id:每个 surebet 的 id 保持不变。带过滤条件的响应不带 ETag,所以只能靠请求间隔节省配额:Pro 上每 10 秒一次,即每天 86,400 / 10 = 8,640 次调用,30 天 8,640 × 30 = 259,200 次,配额为 5M,见 Genesis API 限额。league、platform(例如 fonbet)和 max_days 过滤器在预测市场 endpoint 指南中有说明。
API 无法检查的风险
API 根据快照给 surebet 定价,而投注要由你自己在两三个平台上完成,其中任何一个环节都可能破坏计算。
- 赔率会变动。 快照和你下注之间相隔几秒或几分钟:博彩公司调低赔率,或订单簿中的低价挂单被吃掉。
- 限额与限注。 博彩公司可能只接受比你要求更少的金额,或限制账户;原因见 博彩公司为什么限制套利者。先下赔率投注,再按被接受的金额买入 YES 或 NO。
- 作废(void)。 如果比赛取消或延期,博彩公司通常按赔率 1 退还投注,而 YES/NO 市场按自己的规则结算,surebet 可能以亏损告终。
- 货币。 卢布与美元之间的换算不计入该行的利润。
- 明显错误赔率。 远高于其他博彩公司的赔率可能是错误,博彩公司可能重新结算该投注。
各国对博彩的监管不同:请核对当地法律和各平台的规则。操作流程和所有风险汇总在课程 surebet 风险与操作规则中,搜索的原理见 surebet 扫描器。
各列、过滤器和标签见 Sport 模式指南。
常见问题
有免费的体育赔率 API 吗?
取决于服务商:请求额度以及博彩公司和市场的范围各不相同,免费访问(如果有)在用量上也有限制。Polymarket 和 Kalshi 通过官方 API 免密钥提供市场数据(Polymarket、Kalshi),但那是 YES 和 NO 合约的价格,没有博彩公司的赔率。Genesis API 没有免费套餐:mode=sport 包含在 Pro(每月 $100)和 Max($200)中;套餐对比见 Genesis API 价格。
API 有滚球赔率吗?
Genesis API 没有:sport 模式只查找赛前 surebet,比赛一开始 surebet 就会从响应中消失。滚球套利为什么更容易失败,见 赛前与滚球套利。
为什么 surebet 的 profit_usd 是 null?
至少有一条腿是博彩公司的投注,而博彩公司不会公布针对你账户的投注限额。profit_pct 百分比是已知的;请根据 stake_unit 计算每条腿的金额。
可以通过 Genesis API 下注吗?
不可以。Genesis API 只读取数据:投注和买入由你自己在各平台上完成,使用 legs[].url 中的链接。