Kalshi Agent

核心功能

Kalshi Agent 是一款面向 Kalshi 预测市场平台的命令行交易工具，提供从市场研究到订单执行的完整工作流。

市场研究与浏览

• kalshi markets：列出开放市场，支持数量限制和状态筛选
• kalshi search：多策略智能搜索，支持关键词、代码、类别查询，自动展开体育别名（如 nfl→football）
• kalshi series：交互式系列浏览，支持层级钻取
• kalshi detail 与 kalshi orderbook：查看单个市场详情和订单簿深度

搜索算法特色
采用三层递进策略：直接代码查找 → 系列匹配（动态检索标题/标签/类别）→ 市场标题回退。系列匹配支持交互式编号选择，可连续探索多个系列而无需重复执行命令。

投资组合管理

• kalshi balance：账户余额查询
• kalshi positions：持仓查看
• kalshi orders：未成交订单管理

交易执行

• kalshi buy/sell：支持限价单，价格以美分计（如 68 = $0.68 = 68% 隐含概率）
• 默认 YES 方向，可选 --side no
• 成本预估与二次确认（--force 跳过）
• kalshi cancel：撤销未成交订单

实用特性

• 人性化时间显示（"8h 35m"、"Fri 04:00PM"）
• --min-odds 过滤低流动性市场（默认 0.5%）
• --expiring 按到期时间排序并显示到期列
• 价格双显：美元金额 + 百分比概率

优点

• 交互式 CLI 设计流畅，搜索层级清晰
• 多维度过滤（赔率、到期时间、类别）提升决策效率
• 价格百分比转换直观呈现市场概率
• 支持批量探索和连续操作，减少重复命令

局限性与风险

• 合规限制：Kalshi 仅限美国部分州可用，用户需自行确认属地合法性
• 资金风险：预测市场为零和博弈，存在本金亏损可能
• API 依赖：私钥文件和访问密钥配置门槛较高，密钥泄露风险
• 流动性风险：部分市场买卖价差大，--min-odds 虽可过滤但可能遗漏机会
• 无回测功能：缺乏历史数据验证策略

适合人群

• 对预测市场有认知的量化交易者
• CLI 重度用户，偏好键盘驱动的效率操作
• 需要快速扫描多市场、对比概率的信息交易者

安全提示

• RSA 私钥必须妥善保管，建议设置文件权限 600
• 避免在共享环境存储 KALSHI_ACCESS_KEY
• 首次使用建议小额测试，熟悉订单确认流程

核心用法

Kalshi Agent 是一款面向 Kalshi 预测市场的命令行交易工具封装 Skill。Kalshi 是美国首家受监管的预测市场交易平台，用户可通过买卖事件合约对各类事件结果进行预测。该 Skill 提供完整的市场浏览、研究和交易功能：

市场研究功能：支持按关键词、代码或类别搜索市场，查看市场详情和订单簿深度。内置多策略搜索，自动匹配事件代码、系列标签和市场标题。交互式系列列表允许用户通过编号快速钻取特定市场的合约详情。

交易执行功能：支持买卖 YES/NO 二元合约，以美分定价（如 68 表示 $0.68，对应 68% 隐含概率）。提供成本预估和确认提示，可通过 --force 跳过确认。支持订单取消和持仓查看。

组合管理功能：实时查看账户余额、当前持仓和未完成订单，帮助用户跟踪资金状况。

显著优点

1. 官方 API 集成：直接调用 Kalshi 官方 v2 API，数据源权威可靠，接口规范稳定。

2. 智能搜索体验：多策略搜索自动识别代码前缀（KX）、扩展体育类别别名（如 nfl→football），交互式编号选择大幅提升市场浏览效率。

3. 人性化交互设计：到期时间显示为"8h 35m"等自然语言，价格同时显示美元和百分比，合约名称优先展示可读标签而非原始代码。

4. 灵活过滤选项：支持按最小赔率过滤低流动性市场，按到期时间排序，帮助用户聚焦高价值交易机会。

潜在缺点与局限性

1. 金融交易风险：涉及真实资金操作，价格以美分计但对应实际美元盈亏，新手易误解合约价值。

2. 凭证管理负担：需用户自行获取并安全存储 RSA 私钥和 API 访问密钥，本地文件存储存在泄露风险。

3. 外部依赖风险：Skill 本身为文档封装，核心功能依赖上游 kalshi-cli npm 包，供应链安全性需用户自行验证。

4. 地域限制：Kalshi 平台受美国监管，非美国用户可能无法注册或使用，且部分州存在限制。

5. 市场流动性风险：预测市场可能出现低流动性情况， --min-odds 过滤虽有帮助但无法完全避免滑点。

适合的目标群体

• 量化交易研究者：希望通过 CLI 自动化获取预测市场数据、测试策略的分析师
• 事件驱动型投资者：关注政治、体育、经济事件并愿意通过合约表达观点的交易者
• 数据科学爱好者：需要结构化事件预测数据用于研究或建模的学术人员
• CLI 重度用户：偏好终端操作、熟悉金融衍生品概念的技术型用户

不适合人群：无金融衍生品经验的新手、无法接受本金损失风险的用户、寻求"被动收益"的保守型投资者。

使用风险与注意事项

资金安全风险：该 Skill 直接操作真实资金账户，误操作或 API 密钥泄露可能导致不可逆损失。建议创建专用 API 密钥并限制权限，定期轮换凭证。

供应链风险：kalshi-cli 由个人开发者维护，建议安装前审查源码（github.com/JThomasDevs/kalshi-cli），使用 npm audit 检查依赖。

性能与稳定性：依赖外部网络连接至 Kalshi 服务器，API 限流或故障可能影响交易执行。高频交易场景需自行实现重试和容错机制。

合规风险：用户需确保所在司法管辖区允许预测市场交易，自行承担税务申报义务。美国境外用户应确认平台服务条款。