OctagonAI/kalshi-trading-bot-cli

AI-native CLI for trading Kalshi prediction markets. Runs deep fundamental research, generates independent probability estimates, computes edge vs. live order books, and executes trades with Kelly sizing and a 5-gate risk engine.

Kalshi Trading Bot CLI – 何であるか

Kalshi Trading Bot CLI は、Kalshi予測市場プラットフォームで取引を行うためのコマンドラインアプリケーションです。Octagon ResearchによるAI生成確率推定を用いて、モデル価格とリアルタイムの注文簿の間に存在するエッジを検出し、半ケリー法によるポジションサイズ決定と、組み込みの5ゲートリスクエンジンを活用します。

コア機能

分野	ボットの機能
市場発見	`search`, `similar`, `clusters`, `peers` – オクタゴンの埋め込み（APIキー提供時）を活用した、すべてのKalshi市場における意味的・キーワード検索。
エッジ検出	`analyze`（または `search edge`）はOctagonのモデル確率を取得し、市場価格と比較してエッジと信頼度を報告します。
ポジションサイズ決定	半ケリー法（`kelly`フラグ）を用い、設定可能なリスク上限（流動性、集中度、ドローダウンなど）を尊重します。
バスケット構築	`basket build`はクラスターキャップと相関制限を用いて多様化されたマルチレッグバスケットを作成；`basket backtest`は過去のリターン、シャープレシオ、最大ドローダウン、勝率を評価します。
リスク・コンプライアンス	5ゲートエンジン（ケリー、流動性、相関、集中度、ドローダウン）が限界を超える注文をブロック；`mandate/kill/resume`で1日あたりの損失上限を設定可能。
学習ループ	`reflect`は決済済み取引を短い教訓に変換；`hypothesis`は検証可能な主張を追跡；`calibration`はブライアスコアとカテゴリ別スキルを報告。
自動化対応	`--json`フラグで機械可読出力、`--dry-run`でスキャンのみ、グローバルバイナリ（`kalshi`）でスクリプトや並列実行に対応。
ペーパートレーディング	`paper buy/sell`でリアルな価格を用いて戦略をテスト（実金リスクなし）。
レポート	`report`, `trust`, `themes report`, `events` でMarkdown形式の要約、信頼性スコア、カレンダー表示を提供。

使い始め方

Bun（≥ 1.1）をインストール – ボットはBunのネイティブTypeScriptランタイム上で動作し、bun:sqliteを使用します。
ゼロインストールコマンドを実行：
```
bunx kalshi-trading-bot-cli@latest
```
初回起動時に、以下の設定を求めるウィザードが起動します：
- Kalshi APIキー + RSA秘密鍵
- LLMプロバイダーのキー（OpenAI、Anthropicなど）
- オプション：Octagon APIキー（AIエッジ分析用）とTavilyキー（Web調査用）
設定ファイルは ~/.kalshi-bot/ に保存されます（キーを含む.envファイルも含まれます）。
設定後、REPL内で help を入力するか、以下のコマンドを直接実行できます：
```
kalshi search crypto
kalshi analyze KXBTC-26APR-B95000
kalshi buy KXBTC-26APR-B95000 3 58
```

一般的なワークフロー

発見 – search や clusters で関心のある市場を検索。
分析 – analyze <ticker> でモデル確率、市場価格、エッジ、主要要因、ケリー法による注文サイズを表示。
検証 – basket validate や backtest で提案された取引がリスク制限を満たし、過去のパフォーマンスに優れているか確認。
実行 – buy / sell（または paper buy でシミュレーション）。ボットはKalshiに注文を送信する前に5ゲートリスクエンジンをチェック。
監視 – portfolio でリアルタイムのP&Lを表示；watch でリアルタイム価格と注文簿をストリーミング。
学習 – 決済後、calibrationでスキルスコアを確認、reflectで教訓を記録、hypothesisで主張追跡を管理。

拡張性とスクリプティング

JSON出力（--json）により、ボットや自動パイプラインに簡単に統合可能。
グローバルバイナリ（kalshi）で並列実行や他のエージェントとの統合が可能。
カスタムテーマ – 自分の研究アイデアに基づいて、ナラティブバケット（themes）を作成・インポート・編集可能。
デーモンモード（daemon）はキャッシュを温かく保ち、決済を同期し、インタラクティブ使用をブロックせずにバックグラウンドでリフレクションを実行。

使用対象者

予測市場でAI強化されたエッジ検出を求める定量的トレーダー。
LLM駆動の確率予測を実験する研究者。
リスク制御機能付きのスクリプタブルでターミナルベースのKalshiインターフェースを求めるアマチュア。

結論：Kalshi Trading Bot CLIは、市場発見、エッジ分析、リスク意識のあるサイズ決定、バスケット構築、バックテスト、継続的改善のフィードバックループを備えた、完全機能のAI強化コマンドライン取引アシスタントです。Bunをインストール後、単一の bunx コマンドで実行可能です。