OctagonAI/kalshi-trading-bot-cli

Kalshi Trading Bot CLI – 是什麼

Kalshi Trading Bot CLI 是一個命令列應用程式，協助您在 Kalshi 預測市場平台 上進行交易。它使用 AI 生成的機率估計（透過 Octagon Research）來偵測模型價格與即時訂單簿之間的優勢，再以半凱利法進行部位規模計算，並內建五道風險引擎。

核心功能

領域	機器人執行的操作
市場發現	search, similar, clusters, peers – 提供 API 金鑰時，由 Octagon 嵌入技術驅動，於所有 Kalshi 市場進行語意與關鍵字搜尋。
優勢偵測	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 命令即可執行。