核心用法
Kalshi Agent 是一款面向 Kalshi 预测市场的专业 CLI 交易工具，基于官方 v2 API 构建，提供完整的市场浏览、研究分析和交易执行能力。
市场研究功能：用户可通过 kalshi markets 列出开放市场，支持状态过滤和数量限制；kalshi search 提供多策略智能搜索，支持按关键词、代码或类别查找，并内置别名扩展（如 "nfl" 自动匹配 "football"）；kalshi series 提供交互式系列浏览，输入数字即可下钻查看具体市场；kalshi detail 和 kalshi orderbook 分别用于查看单个市场详情和订单簿深度。
交易功能：kalshi buy/sell 支持以美分定价的合约买卖，默认 YES 方可指定 NO 方，--force 跳过确认；kalshi cancel 用于撤销未成交订单。投资组合管理包括 balance（余额）、positions（持仓）和 orders（挂单）三个命令。
显著优点
- 交互式体验：系列搜索和浏览采用数字选择式交互，操作流畅
- 智能搜索：多层级匹配策略（代码→系列→市场标题），自动别名扩展
- 人性化显示：价格同时显示美元和百分比，到期时间智能格式化（如 "8h 35m"）
- 过滤灵活：支持按赔率阈值（
--min-odds）和到期时间（--expiring）筛选
潜在缺点与局限性
- 地域限制：Kalshi 受美国监管，非美国用户或受限州无法使用
- 资产风险：预测市场属新型衍生品，存在全额本金损失风险
- API 依赖：交易功能依赖 Kalshi 平台稳定性，无离线能力
- 配置门槛：需手动配置 RSA 私钥文件和环境变量，对非技术用户不够友好
适合人群
- 美国境内对预测市场感兴趣的量化交易者
- 熟悉 CLI 操作、具备基础金融衍生品知识的投资者
- 需要自动化或半自动化 Kalshi 交易策略的开发者
常规风险
- 监管风险：Kalshi 作为受 CFTC 监管的平台，规则变更可能影响市场准入
- 流动性风险：部分冷门市场买卖价差大，订单可能无法及时成交
- 技术风险：API 密钥和私钥文件需妥善保管，泄露可能导致账户被盗
- 结算风险：预测事件结果以 Kalshi 判定为准，存在争议可能