核心功能与用法
kalshi-agent 是一个专为 Kalshi 预测市场 设计的 CLI 交易工具，通过官方 v2 API 实现完整的市场分析与执行链路。
核心用法
- 市场发现：
kalshi markets列出开放市场，kalshi search支持多策略搜索（ticker 直接匹配、系列标签模糊搜索、市场标题检索），并自动扩展常见别名（如 "nfl"→"football"） - 交互式浏览：
kalshi series提供编号列表，支持数字键钻取子市场，无需重复执行命令 - 深度分析：
kalshi detail查看单一市场完整信息，kalshi orderbook获取盘口深度 - 组合管理：
balance/positions/orders三位一体监控资金、持仓与挂单 - 交易执行：
buy/sell支持价格（美分单位）和数量指定，--force跳过确认，成本预估前置展示
显著优点
1. 搜索体验优异：智能分层策略减少无效查询，交互式编号列表提升探索效率
2. 信息呈现友好：价格自动显示为美元+百分比双格式（如 $0.68 (68%)），到期时间人性化（"8h 35m"）
3. 风控细节完善：--min-odds 过滤低流动性市场，--expiring 聚焦临近到期标的
4. 工作流整合：支持 shell 环境变量配置（kalshi setup-shell），RSA 密钥本地存储符合金融 API 惯例
局限性与潜在缺点
- 地域限制：Kalshi 本身受美国 CFTC 监管，非美国用户可能无法开户或受限
- 市场深度依赖：预测市场流动性普遍低于传统交易所，大额订单可能产生显著滑点
- 无策略层：纯执行工具，不含量化策略、回测或自动交易框架
- API 速率限制：高频操作需自行处理限流
适合人群
- 事件驱动型投资者（政治、体育、宏观经济事件）
- 量化交易者需轻量级 CLI 执行终端
- 预测市场研究者需批量获取市场数据
常规风险提示
- 资金风险：预测市场为零和博弈，存在本金损失可能
- 流动性风险：部分市场买卖价差大，市价单成本不可控
- 合规风险：用户需自行确认所在司法辖区允许参与预测市场交易
- 密钥安全：RSA 私钥存储于
~/.kalshi/private_key.pem，需确保文件权限（建议chmod 600）