Kalshi-Claw：自然言語で予測市場を取引するOpenClawスキル

AI アシスタントで予測市場を直接取引したい？主要プラットフォームはAPIがないか、統合が煩雑で、注文署名やポジション追跡を自分で処理する必要がある。Kalshi-Clawはこの課題を解決し、OpenClawに完全なKalshi取引機能を自然言語コマンドで提供する。

アーキテクチャはRust + TypeScriptのデュアルランタイム設計：RustコアがRSA-2048署名、オーダーブック解析、ケリー基準のポジションサイジング、ヘッジスコアリングなどCPU集約タスクを処理。TypeScriptがKalshi REST API統合、LLMオーケストレーション、ターミナルUIを担当。

最大の特徴はLLM駆動のヘッジ発見パイプライン。Rustエンジンがまず市場ペアをバッチスコアリングし、上位候補をLLMに送って対偶論理検証を実施——論理的に必然的な含意のみ受理し、相関や「可能性が高い」関係は拒否。結果はカバレッジ別にT1（≥95%）、T2（90-95%）、T3（85-90%）の3段階で表示し、リスク制御されたヘッジポートフォリオ構築を支援。

全ポジションデータはローカルの`~/.kalshi-claw/positions.json`のみに保存、サードパーティサーバーを経由しない。ペーパートレード（DRY_RUN）とKalshiデモ環境でゼロリスク試用が可能。macOSはワンコマンドインストーラーでRust、Node.js等の依存関係を自動処理。

概要

AIアシスタントで予測市場を直接取引したい？主要プラットフォームはAPIがないか統合が煩雑。Kalshi-ClawはOpenClawに自然言語コマンドによる完全なKalshi取引機能を提供する。ChainstackのPolyClaw（Polymarket版）にインスパイアされたが、Kalshiは規制された中央集権型取引所であり、取引フローがよりシンプル。

コア機能

マーケット閲覧・検索

  • `markets trending`：24時間出来高順のトップマーケット
  • `markets search "クエリ"`：キーワード検索
  • `market <ticker>`：オーダーブック深度付きマーケット詳細

取引実行

  • `buy YES/NO <ticker> <金額>`：ポジション購入
  • `sell YES/NO <ticker>`：現在のbid価格で売却
  • Rustコアが自動で約定数量計算：`floor(予算 / ask価格)`
  • RSA-2048 PKCS#1 v1.5署名済み注文
  • ケリー基準による最適ポジションサイジング

例：$50のYESを$0.65で購入 → 76契約 × $0.65 = $49.40コスト、正解時$76.00、純損益+$26.60。

ポジション追跡

  • `positions`：エントリー価格、現在の中値、未実現損益を表示
  • ローカルのみ保存：`~/.kalshi-claw/positions.json`

LLMヘッジ発見（最大の特徴）

  • `hedge scan`：トレンド市場のヘッジ機会をスキャン
  • `hedge scan --query "トピック"`：トピック特定のヘッジ検索
  • `hedge analyze <ticker1> <ticker2>`：特定ペアの分析

パイプライン：

1. Rustエンジンがバッチプリスコアリング：coverage = 1 − (1−pA)(1−pB)

2. 上位候補をLLM（OpenRouter経由）に送り対偶論理検証

3. 論理的に必然的な含意のみ受理、相関は拒否

4. 段階表示：T1（≥95%）、T2（90-95%）、T3（85-90%）

5. 85%未満はデフォルトフィルタ（`--include-weak`で表示可）

フルスキャンはペアごとのLLM検証のため約60-120秒。

技術アーキテクチャ

Rust + TypeScriptデュアルランタイム、napi-rsでNode.jsネイティブアドオンにコンパイル：

Rust層（src/）：RSA署名、オーダーブック解析、ヘッジスコアリング、ケリー基準計算

TypeScript層（lib/ + scripts/）：Kalshi REST APIクライアント、LLM統合、ローカルポジション保存、ターミナルUI

インストール

macOSワンコマンドインストール

curl -fsSLk https://github.com/Kirubel125/Kalshi-Claw/archive/refs/heads/main.zip -o /tmp/cw.zip && \
unzip -qo /tmp/cw.zip -d /tmp && cd /tmp/Kalshi-Claw-main && bash install.sh

設定

必須：KALSHI_API_KEY、KALSHI_PRIVATE_KEY（PKCS#1 PEM）、OPENROUTER_API_KEY（無料枠あり）。オプション：KALSHI_USE_DEMO（デフォルトtrue）、MAX_BET（デフォルト$25）、DRY_RUN、KALSHI_LLM_MODEL（デフォルトnemotron-nano無料）。

自然言語での使用（OpenClaw統合時）

  • "What's trending on Kalshi?" → マーケット概要
  • "Run Kalshi hedge scan limit 15" → LLMヘッジ分析（約60秒）
  • "Buy $50 YES on market KXFED-25DEC-T525" → 取引実行
  • "Show my Kalshi-Claw positions" → 保有・損益確認

プライバシーとセキュリティ

全ポジションデータはローカル保存のみ。デモ環境とDRY_RUNモードでゼロリスクテスト可能。RSA秘密鍵はローカル署名にのみ使用。

ライセンス：MIT | 作者：Kirubel125