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 中是什么样子。
| Polymarket | Kalshi | |
|---|---|---|
| 市场分组 | 包含一个或多个市场的事件 | 包含事件的系列 |
| 市场 | 有 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 | 钱包持仓和活动、价格历史 |
| WebSocket | market 频道提供订单簿和价格;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 里。
什么时候需要密钥
| 内容 | Polymarket | Kalshi |
|---|---|---|
| 市场、价格、订单簿(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 上的 YES | 0.40 挂 500、0.41 挂 500 | 200 + 205 = $405 |
| Kalshi 上的 NO | 0.55 挂 600、0.56 挂 400 | 330 + 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 | 在同一平台上买入同一事件每个结果的 YES | Start、Pro、Max |
llm | 经 AI 验证的事件对 | Pro、Max |
sport | 13 个平台上的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-money | 24 小时内的大额交易和巨鲸、内幕模式、持仓集中度 | Pro、Max |
/predictions/trades | Polymarket 成交流水:实时从 $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 套餐中。