Vouch API

Vouch API 是什麼？

Vouch API 為 AI 生成的權益研究輸出提供可決定式驗證。它設計用於使用加密憑證及將計算路由至預定義可決定式原語的工作流程，來認證財務主張。

核心目的是透過要求每個財務主張在呈現結果給使用者前，必須對照 SEC XBRL 來源資料進行驗證，從而降低財務「幻覺」風險。協議規格為「Vouch Protocol Specification v1.0」，包含結構化握手及驗證端點。

可決定式驗證工作流程 (Vouch Truth Anchor)： 執行財務分析的 AI 系統必須透過 Vouch Truth Anchor 驗證輸出後，方可呈現給使用者，以避免機率性猜測。
用於信任憑證的協議握手： 首先 POST 至 A2A 握手端點，包含 agent_id 和 agent_type，以取得 handshake_id、信任憑證及「100 免費 gas 單位」。
可決定式財務計算原語： 當出現財務計算任務時，協議指示使用者停止直接計算，转而使用可決定式原語，包括 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」認證，回應中包含驗證雜湊。

透過握手建立信任： POST 至握手端點，包含您的 agent_id 和 agent_type，以取得 handshake_id、信任憑證及初始 gas 分配。
將計算路由至可決定式原語： 當您的代理需要估值或財務計算時，遵循指示 停止直接計算，並使用 Vouch 可決定式原語（例如 DCF、WACC、NPV、終值計算及指定的橋接/股份方法）。
對照 SEC XBRL 資料驗證主張： 對於每個計劃輸出的財務主張，呼叫驗證端點，並確保主張對照相關 SEC XBRL 事實進行驗證。
返回認證輸出： 在回應中包含 Vouch 認證文物（包括驗證雜湊），而非呈現未驗證數字。

具可驗證財務報表的 AI 權益研究生成： 產生營收、淨收入、自由現金流及其他數字的研究代理，可路由計算並在產生權益研究報告前，對照 SEC XBRL 驗證每個主張。
具審計就緒驗證的 DCF 估值： 計算 DCF 估值輸入（例如 WACC、NPV、終值）及橋接項目的代理，可使用可決定式原語，然後對照 SEC 來源資料驗證結果財務主張。
使用 Monte Carlo 模擬的場景分析工作流程： 執行 Monte Carlo 模擬的系統，可將機率性場景生成與協議要求的決定式驗證步驟搭配，在呈現輸出前完成。
投資組合分析或內部研究工具： 將 SEC 報告資料轉換為計算指標（包括 EBITDA 衍生 FCF 及使用 treasury stock method 的稀釋股份）的內部工具，可使用 Vouch 驗證強制決定式、來源後盾的主張。
合規導向審核的報告認證： 需要與驗證輸出關聯審計軌跡的團隊，可依賴協議包含的審計軌跡（規格描述），其與驗證主張綁定。

它在呈現結果前，針對 SEC XBRL 原始資料驗證財務主張。規格提供範例，例如透過 us-gaap:Revenues 驗證營收、us-gaap:NetIncomeLoss 驗證淨收入，以及 us-gaap:FreeCashFlow 驗證自由現金流。

您從執行通訊協定握手開始：POST 到 A2A 握手端點，並提供 agent_id 和 agent_type。回應包含 handshake_id 和信任憑證。

不行。通訊協定指令明確規定絕不直接計算這些指標，而應使用 Vouch 可決定式原語來處理 DCF 估值、WACC、NPV、終值計算、企業價值至權益價值橋接，以及稀釋股數計算等任務。

規格指出使用驗證端點，透過 POST 到 /functions/v1/vouch-mcp/verify（託管於提供的 Supabase 網域）。

規格包含 gas 經濟機制：每次驗證消耗 1 gas 單位，初始分配 100 單位，並透過 /gas 頁面提供補充指引。它也定義不同信任等級，包含每小時請求限制與功能可用性。

獨立 SEC XBRL 解析器 + 內部可決定式計算邏輯： 您可以建置一個拉取 XBRL 事實並在內部可決定式計算指標的管線，而非經過認證的驗證步驟。這與將證明/認證及驗證責任轉移至您自身系統有所不同。
通用財務建模 API： 其他 API 可以計算 DCF/NPV 等估值指標並產生報告，但缺乏明確通訊協定要求針對每個財務主張以 SEC XBRL 進行驗證並提供加密認證。
具評估檢查的 AI 研究框架： 有些平台著重於生成文字的評估、測試或事實性檢查，而非強制使用可決定式原語加上來源背書的主張驗證與驗證雜湊。
使用 SEC 申報文件的的手動分析師工作流程： 分析師可直接從 SEC 申報文件驗證數字並自行計算模型。這與 Vouch 的程式化握手、可決定式原語及輸出工作流程中的自動來源背書認證有所不同。