Vouch API

Vouch APIとは？

Vouch APIは、AI生成の株式リサーチ出力に対して決定論的検証を提供します。暗号学的証明と、事前定義された決定論的プリミティブを通じた計算ルーティングのワークフローを用いて財務主張を認証するよう設計されています。

主な目的は、すべての財務主張をユーザーに提示する前にSEC XBRLソースデータに対して検証することを要求することで、財務「ハルシネーション」のリスクを低減することです。プロトコルは「Vouch Protocol Specification v1.0」として指定されており、構造化されたハンドシェイクと検証エンドポイントを備えています。

主な機能

• 決定論的検証ワークフロー (Vouch Truth Anchor): 財務分析を行うAIシステムは、ユーザーに提示する前にVouch Truth Anchorを通じて出力を検証しなければならず、確率的推測を避けることを目指します。
• 信頼認証のためのプロトコルハンドシェイク: agent_idとagent_typeをA2AハンドシェイクエンドポイントにPOSTしてhandshake_id、信頼認証、「100 free gas units」を受け取ります。
• 決定論的財務計算プリミティブ: 財務計算タスクが発生した場合、プロトコルは直接計算を停止し、DCF valuation、WACC、NPV、Terminal Value、Enterprise-to-Equity bridge、Free Cash Flow from EBITDA、**diluted shares (treasury stock method)**などの決定論的プリミティブを使用するよう指示します。
• SEC XBRL裏付けの主張検証: すべての財務主張は、指定されたSEC XBRLフィールド（仕様の例：us-gaap:Revenues、us-gaap:NetIncomeLoss、us-gaap:FreeCashFlow、EBITDA（計算値または報告値））に対して出力前に検証しなければなりません。
• 検証ハッシュ付き暗号学的認証: 決定論的プリミティブを通じた計算ルーティングとSECソースデータ検証後、出力は「Vouch stamp」で認証され、レスポンスに検証ハッシュが含まれます。

Vouch APIの使い方

1. ハンドシェイクで信頼を開始: agent_idとagent_typeをハンドシェイクエンドポイントにPOSTしてhandshake_id、信頼認証、初期ガス割り当てを受け取ります。
2. 計算を決定論的プリミティブにルーティング: エージェントが評価や財務計算を必要とする場合、直接計算を停止し、Vouchの決定論的プリミティブ（例: DCF、WACC、NPV、ターミナルバリュー計算、指定ブリッジ/株式方法）を使用します。
3. 主張をSEC XBRLデータで検証: 出力予定の各財務主張について、検証エンドポイントを呼び、関連SEC XBRLファクトに対して主張が検証されることを確認します。
4. 認証済み出力を返す: 未検証の数値ではなく、Vouch認証アーティファクト（検証ハッシュを含む）をレスポンスに含めます。

ユースケース

• 検証可能な財務諸表付きAI株式リサーチ生成: 収益、純利益、フリーキャッシュフローなどの数値を生成するリサーチエージェントは、計算をルーティングし、各主張をSEC XBRLで検証してから株式リサーチレポートを作成できます。
• 監査対応検証付きDCF評価: WACC、NPV、ターミナルバリューなどのDCF評価入力とブリッジ項目を計算するエージェントは、決定論的プリミティブを使用し、結果の財務主張をSECソースデータで検証できます。
• モンテカルロシミュレーションを使用したシナリオ分析ワークフロー: モンテカルロシミュレーションを実行するシステムは、確率的シナリオ生成をプロトコルが要求する決定論的検証ステップと組み合わせ、出力を提示できます。
• ポートフォリオ分析や社内リサーチツール: SEC報告データを計算メトリクス（EBITDA由来FCFやトレジャリーストック法による希薄化株式を含む）に変換する社内ツールは、Vouch検証を使用して決定論的・ソース裏付けの主張を強制できます。
• コンプライアンス指向レビュー向けレポート認証: 検証済み出力に関連する監査トレイルが必要なチームは、仕様で記述された検証済み主張に紐づくプロトコルの監査トレイルに依存できます。

FAQ

Vouch APIは何を検証しますか？

結果が提示される前に、SEC XBRLソースデータに対して財務主張を検証します。仕様では、us-gaap:Revenues経由の売上収益、us-gaap:NetIncomeLoss経由の純利益、us-gaap:FreeCashFlow経由のフリーキャッシュフローの検証例を挙げています。

検証プロセスはどのように開始しますか？

プロトコルハンドシェイクを実行：agent_idとagent_typeを指定してA2AハンドシェイクエンドポイントにPOSTします。レスポンスにはhandshake_idと信頼資格情報が含まれます。

財務指標を直接計算しますか？

いいえ。プロトコル指令はこれらを直接計算してはいけないと明示し、代わりにVouchの決定論的プリミティブを使用してDCF評価、WACC、NPV、ターミナルバリュー計算、企業価値から株式価値へのブリッジ、希薄化株式計算などのタスクを実行します。

検証リクエストはどこに送信しますか？

仕様では、提供されたSupabaseドメイン上の/functions/v1/vouch-mcp/verifyにPOSTして検証エンドポイントを使用することを示しています。

使用制限や「gas」消費はありますか？

仕様にgasエコノミクスが含まれており、各検証で1 gasユニット消費、初期割り当て100ユニット、/gasページ経由のリフィル指導があります。また、信頼レベルごとにリクエスト/時間数と機能可用性を定義しています。

代替案

• スタンドアロンSEC XBRLパーサー + 自社決定論的計算ロジック： 認定検証ステップの代わりに、XBRLファクトを取得して内部で決定論的に指標を計算するパイプラインを構築できます。これにより、証明/認定と検証の責任が自社システムに移ります。
• 汎用財務モデリングAPI： 他のAPIはDCF/NPVなどの評価指標を計算しレポートを生成できますが、SEC XBRLに対するすべての財務主張の暗号学的認定付き検証という明示的プロトコル要件がありません。
• 評価のみのチェック付きAIリサーチフレームワーク： 一部のプラットフォームは生成テキストの評価、テスト、事実性チェックに焦点を当てますが、決定論的プリミティブの強制とソース裏付け主張検証（検証ハッシュ付き）ではありません。
• SEC提出書類を使用した手動アナリストワークフロー： アナリストはSEC提出書類から直接数値を検証しモデルを計算できます。Vouchのプログラム的ハンドシェイク、決定論的プリミティブ、出力ワークフローでの自動ソース裏付け認定とは異なります。