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 服务器可用性，无离线功能。
• 合规风险：用户需自行确保交易行为符合当地监管要求。

核心用法

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

主要功能模块

市场研究与浏览

• kalshi markets：列出开放市场（支持数量限制、状态筛选）
• kalshi search：多策略智能搜索（支持关键词、代码、类别，含别名扩展如"nfl"→"football"）
• kalshi series：交互式系列浏览，支持编号选择钻取子市场
• kalshi detail/orderbook：查看单市场详情与订单簿深度

搜索增强功能

• --min-odds / -m：过滤低流动性市场（如 2% 最小赔率阈值）
• --expiring / -e：按到期时间排序，显示人性化时间格式（"8h 35m"、"Fri 04:00PM"）
• 交互式编号列表：选择数字即可钻取系列市场，无需重复执行命令

交易执行

• kalshi buy/sell <ticker> <数量> <价格(分)>：支持 YES/NO 双向交易
• --force：跳过确认提示用于自动化场景
• kalshi cancel <order-id>：撤单管理

组合管理

• kalshi balance/positions/orders：账户余额、持仓、挂单查询

显著优点

1. 交互式体验设计：系列浏览采用编号选择模式，支持连续钻取多个市场而不退出程序
2. 专业交易功能：支持订单簿查看、人性化到期时间显示、赔率过滤等机构级功能
3. 价格双轨显示：同时展示美分价格和隐含概率（如 $0.68 (68%)），降低认知成本
4. 智能别名系统：自动扩展运动联赛等常见别名，提升搜索效率
5. 安全架构：采用 RSA 私钥 + Access Key 双因素认证，私钥本地存储

潜在缺点与局限性

1. 依赖上游 npm 包：核心功能依赖个人开发者维护的 kalshi-cli，非 Kalshi 官方出品，存在供应链风险
2. 仅限 Kalshi 平台：不支持 Polymarket、PredictIt 等其他预测市场
3. 需要手动配置密钥：私钥文件和环境变量配置对新用户有一定门槛
4. 无策略回测功能：纯执行工具，不包含历史数据分析或策略模拟
5. T3 来源可信度：维护者为个人开发者账号，需自行审查代码

适合人群

• 事件驱动交易者：政治、体育、经济事件的结果押注参与者
• 量化交易开发者：需要 CLI 工具进行自动化策略集成
• 预测市场研究人员：需要批量查询市场数据与流动性分析
• Kalshi 平台活跃用户：已持有 Kalshi 账户，需要比网页更高效的工具

常规风险

• API 密钥泄露风险：私钥文件若权限设置不当或被误提交至版本控制，可能导致账户被盗
• 交易执行风险：--force 标志跳过确认，自动化脚本中的逻辑错误可能导致非预期下单
• 上游供应链风险：kalshi-cli 包的恶意更新可能破坏本工具安全性
• 监管合规风险：预测市场在某些司法辖区受限，用户需自行确认本地法规
• 流动性风险：低赔率市场（可被过滤）可能存在成交困难

安全配置建议

# 私钥文件权限最小化
chmod 600 ~/.kalshi/private_key.pem

# 环境变量隔离（避免写入 .bashrc）
export KALSHI_ACCESS_KEY="your_key"