Kalshi API 用于访问美国受 CFTC 监管的预测市场交易所,交易和查询真实世界事件的二元 yes/no 合约,价格范围 1-99 美分,代表隐含概率;Yes 合约 65 美分即市场隐含 65% 概率,结算时 Yes 付 1.00 美元、No 付 0,所有金额均以美分为单位。
用途与数据层级:结构为 Series > Events > Markets。Series 是重复事件模板(如月度就业报告),Events 是系列中的具体实例,Markets 是事件内的单个二元结果。Ticker 格式如 Series:KXBTC、KXJOBLESS、KXINX;Event:KXBTC-25MAY30;Market:KXBTC-25MAY30-T100000。体育赛事 ticker 格式不同:{SERIES}-{YYMONDD}{TEAM1}{TEAM2}-{TEAM}。
主要能力:公开 GET 端点可无需鉴权查询 markets、events、orderbooks;鉴权端点支持下单、撤单、改单、查询余额与持仓、成交、结算、存款与取款记录、订单组、子账户、RFQ 报价、API 密钥管理、账户限额、历史数据、里程碑、结构化目标、多元事件集合与激励计划。还提供 K 线、预测百分位历史、实时里程碑与比赛数据,以及 WebSocket 通道。
使用方式:Base URL 为 https://external-api.kalshi.com/trade-api/v2,Demo 为 https://external-api.demo.kalshi.co/trade-api/v2。API key 需在 https://kalshi.com/account/api-keys 获取(需 Premier 或 Market Maker 等级)。鉴权使用 RSA 密钥对签名,需要三个请求头:KALSHI-ACCESS-KEY、KALSHI-ACCESS-SIGNATURE、KALSHI-ACCESS-TIMESTAMP。签名必须使用 RSA-PSS(SHA256),不能使用 PKCS1v15,否则返回 401;签名前必须去掉查询字符串,仅对裸路径签名。
重要限制:不要用 /markets?keyword= 查询体育、选举等基于系列的市场,该方式只返回多场串关捆绑,不含实际比赛级市场;应按 Series → Events → Markets 导航,使用 /events?series_ticker=KXXX。游戏市场通过 /markets/{ticker} 可能返回 404,买卖报价仅在事件端点响应中出现(/events/{event_ticker}?with_nested_markets=true)。列表端点使用基于 cursor 的分页。费率采用按 API 等级扩展的 token 制,检查限额用 GET /account/limits。
适用场景:交易或浏览美国受监管事件市场,如 CPI、就业报告等经济数据,以及体育比赛、政治竞选、公司相关事件。
限制与注意:官方资料未提供具体收费标准、交易费用与全部平台支持细节,暂未提供。