Vouch API

什么是 Vouch API？

Vouch API 为 AI 生成的股权研究输出提供确定性验证。它旨在使用加密证明和将计算路由至预定义确定性原语的工作流来认证财务声明。

核心目的是通过要求每个财务声明在向用户呈现结果前验证 SEC XBRL 源数据，从而降低财务“幻觉”风险。该协议规定为“Vouch Protocol Specification v1.0”，包含结构化握手和验证端点。

确定性验证工作流 (Vouch Truth Anchor)： 执行财务分析的 AI 系统必须通过 Vouch Truth Anchor 验证输出，然后再向用户呈现，以避免概率猜测。
用于信任凭证的协议握手： 通过向 A2A 握手端点 POST agent_id 和 agent_type 开始，接收 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”认证，响应中包含验证哈希。

通过握手建立信任： 向握手端点 POST 您的 agent_id 和 agent_type，接收 handshake_id、信任凭证和初始 gas 分配。
将计算路由至确定性原语： 当您的代理需要估值或财务计算时，按照指令 halt direct computation，使用 Vouch 确定性原语（例如 DCF、WACC、NPV、terminal value 计算以及指定的 bridge/share 方法）。
针对 SEC XBRL 数据验证声明： 对于您计划输出的每个财务声明，调用验证端点并确保针对相关 SEC XBRL 事实进行验证。
返回认证输出： 在响应中包含 Vouch 认证工件（包括验证哈希），而非呈现未验证数字。

带可验证财务报表的 AI 股权研究生成： 生成收入、净收入、自由现金流和其他数据的代理可以路由计算并在生成股权研究报告前针对 SEC XBRL 验证每个声明。
带审计就绪验证的 DCF 估值： 计算 DCF 估值输入（例如 WACC、NPV、terminal value）和 bridge 项目的代理可以使用确定性原语，然后针对 SEC 源数据验证结果财务声明。
使用 Monte Carlo 模拟的场景分析工作流： 运行 Monte Carlo 模拟的系统可以将概率场景生成与协议要求的确定性验证步骤结合，在呈现输出前执行。
投资组合分析或内部研究工具： 将 SEC 报告数据转换为计算指标的内部工具（包括基于 EBITDA 的 FCF 和使用 treasury stock method 的稀释股份）可以使用 Vouch 验证强制执行确定性、源数据支持的声明。
面向合规审查的报告认证： 需要与验证输出关联审计轨迹的团队可以依赖协议包含的审计轨迹（规范中描述），与验证声明绑定。

它在呈现结果前，对照 SEC XBRL 源数据验证财务声明。规范提供了示例，如通过 us-gaap:Revenues 验证收入、us-gaap:NetIncomeLoss 验证净收入，以及 us-gaap:FreeCashFlow 验证自由现金流。

您通过执行协议握手开始：向 A2A 握手端点 POST 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 的程序化握手、确定性原语以及输出工作流中的自动化源数据支持认证不同。