Genesis Arbitrage

Genesis Arbitrage · · 阅读约 24 分钟

博彩套利的体育赔率 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.252.2544.44%
博彩公司 @3.603.6027.78%
Polymarket 上 30¢ 的 YES1 / 0.30 = 3.3330%

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.25Betcity0.44444
X,平局@3.60Marathon0.27778
2,Dortmund 胜@3.80Winline0.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_atArsenal — Chelsea,soccer,Premier League
市场market_type、period、line、scoreTOT、FT、2.5
腿platform、side、outcome、coversfonbet、bet、小 2.5、U
价格odds、price_avg、stake_unit、currency2.12、0.471698、RUB
结果size_usd、profit_pct、profit_usd1000、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.52511.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 定价,而投注要由你自己在两三个平台上完成,其中任何一个环节都可能破坏计算。

各国对博彩的监管不同:请核对当地法律和各平台的规则。操作流程和所有风险汇总在课程 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 中的链接。