核心功能
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 - 首次使用建议小额测试，熟悉订单确认流程