核心用法
Kalshi Agent 是 Kalshi 预测市场平台的官方命令行交易工具，基于 Kalshi v2 API 构建。核心功能分为三大模块：
市场研究与浏览
kalshi markets列出开放市场，支持分页与状态筛选kalshi search多策略搜索：直接ticker查询、系列匹配、市场标题模糊搜索，支持别名自动扩展（如"nfl"自动匹配"football"）kalshi series交互式浏览市场系列，支持 drill-down 操作kalshi detail查看单市场深度信息，kalshi orderbook查看订单簿
投资组合管理
kalshi balance查询账户余额kalshi positions查看持仓kalshi orders查看未完成订单
交易执行
kalshi buy/sell <ticker> <数量> <价格(分)>执行交易，价格以美分计（68=68%隐含概率）- 支持
--side yes/no指定方向，--force跳过确认，--min-odds过滤低流动性市场
显著优点
1. 官方背书：Kalshi 是美国首家受CFTC监管的事件合约交易所，API 稳定性与合规性有监管保障
2. 交互体验优秀：系列搜索支持编号 drill-down，支持管道输入实现脚本化自动化
3. 时间敏感型工具友好：-e/--expiring 按到期时间排序，人性化显示"8h 35m"等格式，适合短期事件交易
4. 多层级市场结构：清晰区分 Series/Event/Market 三级ticker，便于构建系统化策略
潜在局限与风险
技术门槛：
- 需手动配置 RSA 私钥（
~/.kalshi/private_key.pem）与 Access Key，配置流程对非技术用户不够友好 - 依赖 Python 3 与
cryptography>=41.0.0，跨平台兼容性需验证
功能局限：
- CLI 封装层级较浅，复杂策略需直接调用底层 API（
python -c "import cli"） - 无内置回测、盈亏分析或风险管理模块
市场风险：
- 预测市场流动性高度分化，热门事件（大选、体育）流动性充足，长尾事件可能存在滑点
- 价格以"美分"报价但代表概率，新手易误解为实际美元价格
- 事件结果存在结算争议风险（尽管 Kalshi 有标准化仲裁机制）
适合人群
- 事件驱动型量化交易者
- 政治/体育/加密市场信息优势者
- 需要自动化策略执行的开发者
- 对美国合规衍生品市场感兴趣的专业投资者
常规风险提醒
- 资金安全：API 密钥与私钥本地存储，需确保
~/.kalshi/目录权限安全 - 监管风险：Kalshi 当前仅对美国用户开放，非美国 IP 可能受限
- 流动性风险：部分市场买卖价差较大，大额交易建议先查看 orderbook 深度
- 技术故障：15分钟循环市场（如 KXBTC15M）存在合约切换时机风险，需确认当前活跃 ticker