Genesis Arbitrage

Genesis Arbitrage · · 阅读约 23 分钟

Polymarket API 与 Kalshi API:价格、订单簿,以及两者之间的套利

简而言之

  • Polymarket 和 Kalshi 通过官方 REST API 提供市场、价格和订单簿,无需密钥。下单需要密钥和签名请求,在 Kalshi 上建立 WebSocket 连接也需要密钥。
  • 合约价格是一美元的一部分:0.42 表示 42¢,在市场看来大约是 42% 的概率。只有订单簿能显示特定数量要花多少钱。
  • 平台之间的套利意味着匹配事件、核对结算规则和日期、逐档吃订单簿并扣除手续费。Genesis API 的 /predictions/arbitrage 端点返回已算好这一切的组合;交易由你自己下单。

Polymarket API 和 Kalshi API 是两个预测市场平台的官方编程接口:程序通过它们读取市场、YES 和 NO 合约价格以及订单簿,有密钥和签名请求时还可以下单。两个平台的市场数据都无需密钥即可读取。对两者之间的套利来说,光有价格不够:必须匹配事件,并通过订单簿连同手续费算出利润。现成的组合来自 Genesis API 的 /predictions/arbitrage 端点。

预测市场数据的结构

预测市场交易的是某个事件结果的合约。每个市场都是一个是非问题:事件发生时,YES 合约支付 $1;不发生时,NO 合约支付 $1。平台如何结算市场、价格为何会出现偏差,见文章预测市场入门:Polymarket 和 Kalshi 如何运作和课程什么是预测市场。这里看的是同样的对象在 API 中是什么样子。

PolymarketKalshi
市场分组包含一个或多个市场的事件包含事件的系列
市场有 Yes 和 No 两种结果的二元条件带 ticker 的二元市场
API 中的结果Yes 和 No 各有一个 token ID同一市场的 YES 和 NO 两侧
价格$0.00 到 $1.00美元字符串,例如 "0.4200"
订单簿每个结果各有买单和卖单只有 YES 买单和 NO 买单

价格是一美元的一部分:0.42 表示一份在结果发生时支付 $1 的合约值 42¢。因此价格可以读作市场对概率的估计,这里大约是 42%。Polymarket 网站显示最优买价与卖价的中间值;当价差大于 $0.10 时,显示最新成交价(Polymarket 文档)。要给一笔交易定价,就要用订单簿。

订单簿:买单、卖单与镜像价格

订单簿是买单(bid)和卖单(ask)连同价格和数量的列表。在 Polymarket 上,每个结果有自己的订单簿,通过 token_id 请求。Kalshi 对两侧都只返回买单:价格为 X 的 YES 买单,等同于价格为 $1.00 − X 的 NO 卖单(Kalshi 文档)。

举个示意性的例子:Kalshi 上最优的 NO 买价是 0.58。那么 YES 的卖价是 1 − 0.58 = 0.42,即 42¢。

官方 Polymarket 和 Kalshi API

Polymarket

Polymarket 的数据来自三个 REST API 和 WebSocket 数据流(API 概览)。包括 CLOB 价格和订单簿在内的市场数据无需密钥。

API提供什么
Gamma API事件和市场:元数据、日期、结果 ID
CLOB API价格和订单簿;有密钥时可下单
Data API钱包持仓和活动、价格历史
WebSocketmarket 频道提供订单簿和价格;user 频道提供账户订单和成交

下单需要两步的 CLOB 认证:钱包签名(L1)签发 CLOB 凭证(L2),再由凭证对交易请求签名。订单簿所用的结果 ID 来自 Gamma API:v1 市场把它放在 clobTokenIds JSON 字符串里,v2 市场放在 positionIds 里;索引 0 是 YES,1 是 NO(市场字段)。除了直接发请求,也可以使用官方 Python SDK,即 polymarket-client 包。

Kalshi

对于预测市场,Kalshi 提供 REST API(Trade API v2)、WebSocket 和 FIX。推荐的 REST 主机是 external-api.kalshi.com;旧的 api.elections.kalshi.com 仍可使用,另有单独的演示环境用于测试(API 环境)。系列、事件、市场、订单簿和成交都是公开的。

交易请求用私钥(Ed25519 或 RSA)签名:密钥 ID、时间戳和签名放在 KALSHI-ACCESS-KEY、KALSHI-ACCESS-TIMESTAMP 和 KALSHI-ACCESS-SIGNATURE 请求头里(Kalshi API 密钥)。包括结算规则在内的市场条款以文本形式出现在 rules_primary 和 rules_secondary 中;最优价格在 yes_bid_dollars、yes_ask_dollars、no_bid_dollars 和 no_ask_dollars 里。

什么时候需要密钥

内容PolymarketKalshi
市场、价格、订单簿(REST)无需密钥无需密钥
订单簿数据流(WebSocket)market 频道,无需密钥需要密钥,即使是公开频道
下单钱包签名和 CLOB 凭证用私钥签名的请求

无需密钥读取订单簿:curl 与 Python

# Polymarket: the book of one outcome by token_id
curl "https://clob.polymarket.com/book?token_id=$TOKEN_ID"

# Kalshi: the book of a market by ticker
K=https://external-api.kalshi.com/trade-api/v2
curl "$K/markets/$TICKER/orderbook"

Polymarket 返回 bids 和 asks,各档位带有字符串形式的 price 和 size,另有 tick_size 和 min_order_size。Kalshi 返回一个 orderbook_fp 对象,包含 yes_dollars 和 no_dollars 两个数组,每一档是一对美元价格和合约数量。

只有逐档遍历,才能看出特定数量要花多少钱。下面的函数从最优档开始遍历 Polymarket 的卖单,并返回最优价、平均价和最差价:

import requests

CLOB = "https://clob.polymarket.com"


def walk_asks(token_id: str, shares: float):
    """Best, average and worst price to buy `shares` shares.

    The platform fee is not included here.
    """
    r = requests.get(f"{CLOB}/book", params={"token_id": token_id},
                     timeout=10)
    r.raise_for_status()
    left, cost, prices = shares, 0.0, []
    for level in reversed(r.json()["asks"]):  # the best ask is last
        price, size = float(level["price"]), float(level["size"])
        take = min(left, size)
        cost += take * price
        prices.append(price)
        left -= take
        if left <= 1e-9:
            return prices[0], round(cost / shares, 4), prices[-1]
    return None  # the book is too thin for the full size


print(walk_asks("TOKEN_ID_YES", 1000))

这里的平均价就是订单的 VWAP:买入吃得越深,离最优价就越远。这个差距就是滑点,而挂在最优价附近的数量就是市场深度。

Polymarket 与 Kalshi 之间的套利为何困难

跨平台预测套利,是指在一个平台买 YES、在另一个平台买 NO,且两者合计低于 $1:如果两边结算结果一致,无论发生什么,总有一条腿支付 $1。通过官方 API 比较两个价格很容易;但这一对要变成可执行的交易,还要经过五项检查。

检查项为什么难
事件匹配问题措辞不同,ID 和结构也不同:Polymarket 是含多个市场的事件,Kalshi 是含多个事件的系列
结算规则同一个标题下,来源、措辞和边界情况可能不同
结算日期市场在不同的日子关闭;资金会锁定到较晚的那个日期
手续费公式不同:Polymarket 只有吃单方付费,Kalshi 的费用类型按系列设定
订单簿深度最优价上只能成交有限数量的合约

在 Polymarket 上只有吃单方(taker)付手续费,金额取决于份额价格和市场类别(Polymarket 手续费)。在 Kalshi 上,费用类型和系数记录在系列的 fee_type 和 fee_multiplier 字段里(Kalshi API 中的系列)。你需要提前在两个平台都备好资金,而能否使用每个平台取决于你所在的国家和平台的规则。

算例:Polymarket 买 YES,Kalshi 买 NO

举个示意性的例子:市场“事件 X 在 12 月 31 日前发生”在两个平台都有上架,规则相同,46 天后结算。你想每边各买 1,000 份。

腿订单簿档位成本
Polymarket 上的 YES0.40 挂 500、0.41 挂 500200 + 205 = $405
Kalshi 上的 NO0.55 挂 600、0.56 挂 400330 + 224 = $554

Kalshi 上的 NO 卖单来自 YES 买单:600 份合约、价格 0.45 的 YES 买单就是价格 0.55 的 NO 卖单,400 份、0.44 的买单则是 0.56 的卖单。

按最优价算,这一对的成本是 0.40 + 0.55 = 0.95:每份有 5¢ 的优势,即占投入资金的 0.05 / 0.95 = 5.26%。逐档吃订单簿后的平均成交价是 0.405 和 0.554,合计 0.959,优势缩小到 4.1¢。示例中的手续费是 Polymarket $6、Kalshi $17,共 $23。

利润等于支付额减去两条腿的成本和手续费,年化率(APR)则由距结算的天数得出:

示例中:1,000 − 959 − 23 = $18 利润,18 / 982 × 100 = 占投入资金的 1.83%,1.83 × 365 / 46 = 年化 14.5%。最优价下的 5.26%,在订单簿和手续费之后大约剩下三分之一。

如果两个平台的结算结果一致,无论发生什么,总有一条腿支付 $1,000:投入 $982,回来多出 $18。如果规则出现分歧、两条腿都输,损失就是全部 $982。

Genesis API 中的预测套利

/predictions/arbitrage 端点返回已经完成上述工作的组合。Polymarket、Kalshi、Limitless、Predict.fun 和 Opinion 的市场被匹配起来,每条腿都连同手续费在各自的订单簿里逐档计算,并算出以 $ 和 % 计的利润、APR 和距结算天数。这是预测套利页面的数据,以 JSON 形式提供。

mode得到什么API 套餐
exact两个平台上完全匹配的事件,默认值Start、Pro、Max
dutch在同一平台上买入同一事件每个结果的 YESStart、Pro、Max
llm经 AI 验证的事件对Pro、Max
sport13 个平台上的Surebet 套利盘,仅限赛前Pro、Max

上面算例中的组合,在响应里大致如下,字段有删减:

{
  "kind": "cross",
  "match": "exact",
  "title": "Will event X happen by December 31?",
  "days_left": 46,
  "shares": 1000,
  "size_usd": 959,
  "fees_usd": 23,
  "profit_usd": 18,
  "profit_pct": 1.83,
  "apr_pct": 14.5,
  "risks": [],
  "legs": [
    {
      "platform": "polymarket",
      "side": "yes",
      "price_best": 0.4,
      "price_avg": 0.405,
      "price_worst": 0.41,
      "cost_usd": 405,
      "fee_usd": 6
    },
    {
      "platform": "kalshi",
      "side": "no",
      "price_best": 0.55,
      "price_avg": 0.554,
      "price_worst": 0.56,
      "cost_usd": 554,
      "fee_usd": 17
    }
  ]
}

在每条腿中,side 表示买什么:yes、no 或 bet(博彩公司的投注)。price_best、price_avg 和 price_worst 是逐档吃订单簿时的最优价、平均价和最差价;cost_usd 和 fee_usd 是这条腿的成本和手续费;url 链接到对应市场。距结算不足一天时,apr_pct 为 null。

risks 中的代码标出数学计算无法核实的内容:rules_differ 表示各平台的结算规则可能不同,end_mismatch 表示结算日期不同。在 sport 模式下,含博彩公司腿的组合其 profit_usd = null,因为投注限额未知。Surebet 的内容见关于博彩赔率 API 的文章。

可以用 min_profit_pct、min_profit_usd、min_apr、max_days、platform 和 category 筛选组合。所有筛选条件和字段见指南Genesis API 中的预测市场与 Surebet。不写代码的话,同样的组合在服务页面上也能看到;它的列和标签见指南预测套利。

平台状态、分析与成交

端点返回内容API 套餐
/predictions/platforms平台数据源模式(ws、rest、down)、最新报价和完整扫描的时间、市场数量Start、Pro、Max
/predictions/analytics持仓量和成交量、1 小时和 24 小时价格变动、资金流向Pro、Max
/predictions/smart-money24 小时内的大额交易和巨鲸、内幕模式、持仓集中度Pro、Max
/predictions/tradesPolymarket 成交流水:实时从 $1,000 起,聪明钱包成交从 $100 起,今日和 7d 的吃单方从 $5,000 起Pro、Max
/predictions/traders按 30 天、7 天或全部时间的 PnL 排名的前 300 名 Polymarket 交易者Pro、Max

请求组合的同时也请求 /predictions/platforms:如果某个平台的数据源是 down,组合里它的价格可能已经过时。流水中的每笔成交都带有钱包标签(tags)、insider 标记、taker 或 maker 角色,以及该结果当前的 bid_now 和 ask_now。insider 标签描述的是钱包的行为模式,并不能证明什么。

在 Trial 套餐下,这些端点返回 403 plan_restricted。Start 每月 $50,数据每 30 秒刷新一次;Pro $100,10 秒;Max $200,5 秒。套餐对比见 Genesis API 价格;网站上对应的页面是分析和 Smart Money。

Python:用 min_profit_pct 和 max_days 获取 exact 组合

脚本每隔 meta.freshness_sec 秒获取利润至少 1%、且在 60 天内结算的 exact 组合。它会跳过有平台处于 down 状态的组合,并把其余组合连同逐档吃订单簿的价格打印出来。密钥取自环境变量 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": "exact", "min_profit_pct": 1, "max_days": 60}


def get(path, params=None):
    while True:
        r = requests.get(f"{API}{path}", headers=HEADERS,
                         params=params, timeout=10)
        if r.status_code in (429, 503):
            wait = int(r.headers.get("Retry-After", "5"))
            if wait > 60:  # 周期配额已用完
                raise SystemExit(f"Wait {wait} s: quota exhausted")
            time.sleep(wait)
            continue
        r.raise_for_status()  # 403:你的套餐不含该端点或模式
        return r.json()


while True:
    feeds = get("/predictions/platforms")["data"]["platforms"]
    down = {p["platform"] for p in feeds if p["mode"] == "down"}
    body = get("/predictions/arbitrage", PARAMS)
    for b in body["data"]:
        if any(leg["platform"] in down for leg in b["legs"]):
            continue  # 该平台的价格可能已过时
        print(f"{b['profit_pct']}% · ${b['profit_usd']} · "
              f"APR {b['apr_pct']} · {b['days_left']} d · "
              f"{b['title'][:40]}")
        for leg in b["legs"]:
            print(f"  {leg['platform']} {leg['side']}: "
                  f"{leg['price_best']} / {leg['price_avg']} / "
                  f"{leg['price_worst']}, fee ${leg['fee_usd']}")
        if b["risks"]:
            print("  risks:", ", ".join(b["risks"]))
    time.sleep(body["meta"]["freshness_sec"])

每个循环发出两次调用。在 Start 套餐上,这是每天 2 × 86,400 / 30 = 5,760 次调用,30 天共 5,760 × 30 = 172,800 次,而配额是 200 万次。经过筛选的响应不带 ETag,所以这里能省的是轮询间隔:比 meta.freshness_sec 更频繁地轮询不会带来新数据。更多内容见指南 Genesis API 限额和响应与错误。

常见问题

Polymarket 有官方 API 吗?

有。Gamma API 提供事件和市场,CLOB API 提供价格、订单簿和下单,Data API 提供持仓、活动和价格历史,订单簿更新通过 WebSocket 推送。市场数据无需密钥;下单需要钱包签名和 CLOB 凭证。参见 Polymarket 文档。

读取 Kalshi 市场需要密钥吗?

REST 不需要:系列、事件、市场、订单簿和成交都是公开的(Kalshi 快速开始)。下单和连接 WebSocket 需要密钥,即使你只想订阅公开频道。

可以通过 Genesis API 交易吗?

不可以。Genesis API 只读取数据,不下单。你需要通过 legs[].url 链接,自己在各平台上建立组合的仓位。通过官方 Polymarket 和 Kalshi API 进行自动交易不属于 Genesis API 的范围,风险自负。

数据多久更新一次?

Genesis API 每隔 meta.freshness_sec 提供一份新快照:Start 为 30 秒,Pro 为 10 秒,Max 为 5 秒。各平台自身报价有多新,可看 /predictions/platforms 中的 quotes_at 和 full_scan_at。

Polymarket 和 Kalshi 套利需要哪个 Genesis API 套餐?

Start:包含 exact 和 dutch 模式以及平台状态。llm 和 sport 模式、分析、smart money、成交和交易者排行榜在 Pro 和 Max 套餐中。