SuperAPI AI 工具集

kalshi-api

编程与开发

查看项目

更新于 10-15 16:42

技能介绍

用途:为编写 Kalshi 交易场所适配器(app/venues/kalshi/)提供 API 事实参考,资料固定于文档站,不再从网络重新抓取。

主要能力与要点: 基础地址:生产 https://external-api.kalshi.com/trade-api/v2(备用 https://api.elections.kalshi.com/trade-api/v2),演示 https://external-api.demo.kalshi.co/trade-api/v2。WebSocket 地址 wss://external-api-ws.kalshi.com/trade-api/ws/v2,本套件未使用。 认证:基于 RSA 私钥(PEM)签名,请求头为 KALSHI-ACCESS-KEY、KALSHI-ACCESS-TIMESTAMP(毫秒)、KALSHI-ACCESS-SIGNATURE,算法 RSA-PSS(SHA256, MGF1-SHA256, salt 长度等于摘要长度),签名串为 "{timestamp_ms}{METHOD}{path}",path 不含查询串。 市场数据:价格与数量既有定点美元字符串(yes_bid_dollars 等),也有旧式整数美分,需按字段名而非数值大小判断编码。含规则文本、时间字段、settlement_timer_seconds、result(yes/no/scalar/空)等。 订单簿:GET /markets/{ticker}/orderbook 返回 orderbook_fp,yes_dollars 与 no_dollars 均为买盘;卖盘由对手方买盘推导,yes_asks = 1 - no_dollars,no_asks = 1 - yes_dollars。 下单:V2 用于 YES 方向,POST /portfolio/events/orders,字段含 ticker、side(bid/ask)、count、price、time_in_force、client_order_id、post_only 等。NO 方向与全部撤单走旧接口 POST /portfolio/orders(side="no" 加 action)和 DELETE /portfolio/orders/{order_id};这两个接口在适配器中标记为未验证,字段拼写属假设。 手续费:fee = rate × C × P × (1 − P),标准 taker 0.07、maker 0.0,按笔向上取整到 6 位小数,非直连会员再取整到分;费率在实现时未获确认。 资金:CFTC 监管 FCM 下的美元账户,ACH/电汇出入金,与 Polymarket USDC 不实时互换,默认 transfer_latency_hours=72,各场所独立记账。

用法与限制:签名须在请求时用新的 timestamp 计算;价格直接作为 [0,1] 概率,不做定点转换;数量以合约为单位存为浮点。适配器仅使用 REST 轮询,WebSocket 未实现,调用会抛出 NotImplementedError。