SuperAPI AI 工具集

kalshi-api

数据与分析

查看项目

更新于 10-16 04:58

技能介绍

用途:Kalshi 是受 CFTC 监管的美国事件交易所,合约以美元计价,二元结算为 1.00 美元(YES 胜)或 0.00 美元(NO 胜)。本技能提供与市场类型无关的共享接入层,覆盖 REST 与 WebSocket、每次请求的 RSA-PSS 认证。合约语义与结算规则见 kalshi-weather-markets、kalshi-crypto-index-markets;策略、仓位与回测见 prediction-market-strategy。

主要能力:基础地址 https://api.elections.kalshi.com/trade-api/v2;无公开端点,所有请求均需 RSA-PSS 签名;签名串为 {timestamp_ms}{METHOD}{path},path 含 /trade-api/v2 前缀且不含查询串,算法 RSA-PSS、MGF1/SHA-256、salt 长度 PSS.DIGEST_LENGTH,请求头为 KALSHI-ACCESS-KEY、KALSHI-ACCESS-TIMESTAMP(毫秒)、KALSHI-ACCESS-SIGNATURE(base64)。订单簿中 yes 与 no 均为挂单买价阶梯,无独立卖盘:no_ask = 1 − best_yes_bid,yes_ask = 1 − best_no_bid。下单使用定点美元字符串,如 count_fp、yes_price_dollars、time_in_force、client_order_id(仅 [A-Za-z0-9-]),不要发送 type。端点涵盖余额、持仓、订单、成交、结算、市场、订单簿、K 线、近期成交等。

使用方式:安装 pip install httpx cryptography;凭据用环境变量 KALSHI_KEY_ID 与 KALSHI_PRIVATE_KEY_PATH,密钥在 Kalshi 面板生成,切勿写入代码。示例:get("/markets", params={"series_ticker": "KXHIGHNY", "status": "open"})。K 线 period_interval 为分钟,取值 1、60、1440。

限制:API 曾破坏向后兼容(旧主机 trading-api.kalshi.com 已失效,订单 schema 由整数美分改为美元字符串),编码前务必用实时响应冒烟测试签名与订单体。演示环境 demo-api.kalshi.co 订单簿近乎为空,即使只读也建议用生产环境。若价格值大于 1.0,说明是整数美分,需除以 100。订单簿响应有两种变体,使用前需归一化。完整端点、市场元数据与速率限制见 references/endpoints-and-marketdata.md,WebSocket 见 references/websocket.md,订单生命周期见 references/auth-and-orders.md。