Kurage Stock Brain

Kurage Stock Brain（ksbrain）は日本株・米国株向けの証拠追跡型インテリジェンスAPI

Kurage Stock Brain（ksbrain）は、kurage（株式会社エクスブリッジ）が運用する日本株・米国株向けのインテリジェンスAPIです。kcbrain（暗号資産）やkfxbrain（FX）に続く「Kurage brainシリーズ」の一環として、証拠を優先し、判断より先に根拠を揃える設計を特徴とします。

• プロダクトサイト: https://ksbrain.exbridge.jp/
• 日本語: https://ksbrain.exbridge.jp/ksbrain.html
• リファレンス実装: https://tajp.exbridge.jp/
• 開発時ポート: 18338

概要

• 利用者が権利を持つ市場データや入力資料だけを使い、テクニカル・財務・開示・ニュース・強弱討論・リスク評価を、証拠IDとデータ時点付きのJSONで返します。
• 分析専用であり、証券会社の認証情報・資産管理・注文執行機能はありません。出力は投資助言ではなく、判断を検証するための補助情報です。
• ローカルLLM（Gemma 4）で動作し、有料レールではDeepSeek（deepseek-v4-flash）を使用できます。

設計境界

• 株の分析に専念し、暗号資産用のkcbrainには依存しません。
• LLMはOllamaへ直接接続します。
• 発注、証券口座接続、資産運用は行いません。
• 入力された根拠ID以外を判断の出典として返しません。
• Yahoo Finance等の非公式APIへ黙ってフォールバックしません。
• J-Quantsの利用・再配布条件は利用者自身の契約に従います。
• EDINETは設定状態を公開しますが、0.1.0では自動同期対象外です。

主要機能

• TRACEABLE（証拠ID必須化） : 判断が参照した入力をIDで返し、存在しないIDは除外。資料がなければ「証拠不足」と明示します。
• STRUCTURED（エージェント向けJSON） : 方向・確信度・反証・リスク・不足情報・品質・時点を安定したスキーマで返します。
• BOUNDARY（注文を実行しない） : 証券口座には触れず、ポリシー・数量・人間の承認・執行は呼び出し側に残します。これはtrust-boundaryの考え方と共通です。

認証とx402

• /v1/* はAuthorization: BearerまたはX-API-Keyで利用する内部・契約者向けAPIです。
• /x402/v1/analyze/fullは機械間課金用で、初期状態では無効です。有効化には次が必要です。
  1. .venv/bin/pip install -e '.[x402]'
  2. 受取ウォレット、ネットワーク、facilitatorを明示設定
  3. KSBRAIN_X402_ENABLED=true
• 初期ネットワークはBase Sepolia（eip155:84532）です。公式x402 SDKがPAYMENT-SIGNATUREを検証し、facilitatorで精算します。テストネット専用のhttps://x402.org/facilitatorをBase mainnetで使う設定は起動時に拒否されます。

処理の流れ

1. 収集：手動資料、または利用者の契約下で取得したJ-Quantsデータ（POST /v1/data/jquants/sync。APIキーがない場合はHTTP 503を返し、別データを捏造しません）。
2. 保存：正規化・時刻付与・ハッシュ化を行い証拠IDを発行。
3. 判断：Gemma 4が入力済み証拠だけを評価し、不足も返却。
4. 統合：TradingAgents-JPなどが討論と最終ポリシーを適用。

提供チャネル

• Bankr（x402）: $0.05/コール
• Coinbase CDP / Bazaar（x402）: /ksbrain/* 全スキル$0.05
• JPYC（x402）: 全スキル7.5 JPYC
• Virtuals ACP: 「Kurage AI Project」のofferingとして$0.05
• RapidAPI: カード決済（kurage-stock-brain）

決済にはx402を利用し、サブスクなしの従量課金です。

API構成（抜粋）

• POST /v1/evidence — 追跡可能な証拠の登録
• POST /v1/data/jquants/sync — 日本株の一次データ同期（J-Quants・要契約）
• POST /v1/data/us/sync — 米国株の一次データ同期（SEC EDGAR財務・開示＋日足）
• POST /v1/us/analyze/full — 米株ワンショット：EDGAR自動取得＋7段フル分析
• POST /v1/analyze/technical — 価格・指標評価
• POST /v1/analyze/fundamentals — 財務情報評価
• POST /v1/analyze/disclosure — 開示・資料評価
• POST /v1/debate/bull-bear — 強気・弱気材料の統合
• POST /v1/assess/risk — リスク評価
• POST /v1/analyze/full — 総合分析
• POST /v1/screen/opportunities — 最大10銘柄の比較
• GET /health、GET /docs、GET /.well-known/x402.json — 動作確認・API仕様・x402 discovery

関連プロダクトとの関係

• kcbrain（暗号資産）・kfxbrain（FX）と同じマーケットプレイス群で販売されています。
• リファレンス実装としてtradingagents-jpがあり、ktajp（Kurage TradingAgents）とも関連します。
• kfinanalystのレポートにはksbrainの判断API所見を添付できます。
• kfreqaiやkfxaiと同様に、vibe-tradingの道具として「根拠を追跡できる銘柄インテリジェンス」を提供します。

出典

• kurage-repos（Kurage主要プロダクトのREADME公開repo）
• kurage-lps（Kurage各プロダクトのLP集）
• 関連コンセプト: trust-boundary、x402、local-llm、vibe-trading、ai-judgment-backend