OctagonAI/kalshi-trading-bot-cli

Kalshi Trading Bot CLI – 是什么

Kalshi Trading Bot CLI 是一个命令行应用程序，帮助您在 Kalshi 预测市场平台 上进行交易。它使用 AI 生成的概率估计（通过 Octagon Research）来发现模型价格与实时订单簿之间的优势，然后采用半凯利法进行仓位大小计算，并内置了五道风险引擎。

核心功能

领域	机器人执行的操作
市场发现	search, similar, clusters, peers – 在所有 Kalshi 市场中进行语义和关键词搜索，当提供 API 密钥时，由 Octagon 嵌入技术驱动。
优势检测	analyze（或 search edge）获取 Octagon 模型概率，与市场价格比较，报告优势及置信度。
仓位大小	使用半凯利法（kelly 标志）并尊重可配置的风险上限（流动性、集中度、回撤等）。
篮子构建	basket build 使用集群上限和相关性限制创建多样化的多腿篮子；basket backtest 评估历史收益、夏普比率、最大回撤、胜率。
风险与合规	五道引擎（凯利、流动性、相关性、集中度、回撤）阻止超过限制的订单；mandate/kill/resume 可设置每日亏损上限。
学习循环	reflect 将已结算交易转化为简短经验，hypothesis 跟踪可证伪的主张，calibration 报告布里尔分数和各分类技能。
自动化友好	--json 标志提供机器可读输出，--dry-run 仅用于扫描，全局二进制文件（kalshi）支持脚本或并行调用。
模拟交易	paper buy/sell 允许您使用真实报价测试策略，但无真实资金风险。
报告	report, trust, themes report, events 提供 Markdown 摘要、完整性评分和日历视图。

如何开始

1. 安装 Bun（≥ 1.1）– 该工具在 Bun 的原生 TypeScript 运行时上运行，并使用 bun:sqlite。
2. 运行零安装命令：

   bunx kalshi-trading-bot-cli@latest
   

   首次启动时会启动一个向导，要求您提供：
   • Kalshi API 密钥 + RSA 私钥
   • LLM 提供商密钥（OpenAI、Anthropic 等）
   • 可选：Octagon API 密钥（用于 AI 优势分析）和 Tavily 密钥（用于网络研究）。
3. 配置文件存储在 ~/.kalshi-bot/（包括包含密钥的 .env 文件）。
4. 设置完成后，您可以在 REPL 中输入 help，或直接使用以下命令，例如：

   kalshi search crypto
   kalshi analyze KXBTC-26APR-B95000
   kalshi buy KXBTC-26APR-B95000 3 58
   

典型工作流程

1. 发现 – 使用 search 或 clusters 找到感兴趣的市场。
2. 分析 – analyze <ticker> 显示模型概率、市场价、优势、主要驱动因素和凯利法计算的订单大小。
3. 验证 – 使用 basket validate 或 backtest 确保提议的交易符合风险限制且具有历史表现。
4. 执行 – 使用 buy / sell（或 paper buy 进行模拟）。机器人在向 Kalshi 发送订单前会检查五道风险引擎。
5. 监控 – portfolio 显示实时盈亏；watch 流式传输实时价格和订单簿。
6. 学习 – 结算后，运行 calibration 查看技能评分，reflect 捕获经验，hypothesis 管理主张追踪。

可扩展性与脚本化

• JSON 输出（--json）使工具易于嵌入机器人或自动化流水线。
• 全局二进制文件（kalshi）支持并行运行和与其他代理集成。
• 自定义主题 – 您可以创建、导入或编辑叙事桶（themes），围绕自己的研究想法组织市场。
• 守护模式（daemon）保持缓存活跃，同步结算，并在不阻塞交互使用的情况下运行后台反思。

适合谁使用

• 希望在预测市场中使用 AI 增强优势检测的量化交易员。
• 实验 LLM 驱动概率预测的研究人员。
• 寻找可脚本化、终端式接口且内置风险控制的 Kalshi 入门级爱好者。

---

总结：Kalshi Trading Bot CLI 是一个功能齐全、AI 增强的命令行交易助手，专为 Kalshi 设计，提供市场发现、优势分析、风险意识的仓位大小、篮子构建、回测和持续改进的反馈循环——在安装 Bun 后，仅需一个 bunx 命令即可运行。