kalshi-agent

核心用法

Kalshi Agent Skill 是一个面向预测市场交易平台 Kalshi 的命令行工具封装，允许用户通过自然语言交互完成市场浏览、持仓查询和自动化交易操作。该技能基于 Kalshi v2 API 构建，核心功能分为三大模块：市场研究（markets//search//series//detail//orderbook）、投资组合管理（balance//positions//orders）以及交易执行（buy//sell//cancel）。

用户可通过多策略搜索快速定位目标市场——系统优先尝试直接 ticker 匹配，继而动态检索系列标签，最后回退到市场标题模糊搜索。交互式系列列表支持数字 drill-down 浏览，无需重复执行命令。交易指令以美分为单位定价（68 = $0.68 = 68% 隐含概率），默认买入 YES 合约，可通过 --side no 切换，所有操作均带成本预览与确认提示（--force 可跳过）。

显著优点

1. 交互体验优化：智能搜索策略自动扩展体育别名（如 "nfl" 匹配 "football"），交互式编号列表降低认知负荷，过期时间以人性化格式呈现（"8h 35m" / "Fri 04:00PM"）。
2. 风险控制设计：--min-odds 过滤低流动性市场，，--expiring 聚焦临近到期合约，交易前强制展示成本/收益摘要。
3. 信息密度高：市场表格直接显示 outcome 名称而非原始 ticker，订单簿深度查询辅助价格发现。
4. 权限最小化：仅申请与交易功能严格相关的环境变量与文件路径，无过度权限索取。

潜在缺点与局限性

• 资金来源限制：Kalshi 目前仅对美国用户开放，且受 CFTC 监管，非美国用户无法使用。
• 金融操作不可逆：交易执行直接关联真实资金，无模拟交易模式（需依赖 Kalshi 官方测试环境）。
• 依赖外部包：核心功能委托给 kalshi-cli npm 包，版本锁定机制缺失，存在供应链更新风险。
• 无本地持久化：策略或交易历史需用户自行管理，技能本身不提供回测或分析框架。

适合的目标群体

• 已拥有 Kalshi 账户及 API 权限的美国境内交易者
• 需要 CLI 快速查询持仓、执行策略的量化交易爱好者
• 希望将预测市场数据整合至自动化工作流的数据分析师
• 对政治、体育、金融事件衍生品有研究兴趣的事件驱动型投资者

使用风险

• 资金风险：预测市场合约可能全额损失，杠杆效应放大波动。
• API 凭证泄露：RSA 私钥与 Access Key 存储于本地明文文件，多用户环境需严格权限控制。
• 网络依赖：所有数据与交易依赖 Kalshi 服务器可用性，无离线功能。
• 合规风险：用户需自行确保交易行为符合当地监管要求。