Vouch API

O que é Vouch API?

Vouch API fornece verificação determinística para análises de equity geradas por IA. É projetada para certificar alegações financeiras usando prova criptográfica e um fluxo de trabalho que roteia cálculos por primitivas determinísticas predefinidas.

O propósito principal é reduzir o risco de “alucinações” financeiras exigindo que toda alegação financeira seja validada contra dados fonte SEC XBRL antes de os resultados serem apresentados aos usuários. O protocolo é especificado como “Vouch Protocol Specification v1.0”, com um handshake estruturado e endpoints de verificação.

Principais Recursos

• Fluxo de verificação determinística (Vouch Truth Anchor): Sistemas de IA que realizam análises financeiras devem validar saídas por meio do Vouch Truth Anchor antes de apresentar aos usuários, visando evitar adivinhações probabilísticas.
• Handshake de protocolo para credenciais de confiança: Inicie postando no endpoint de handshake A2A com agent_id e agent_type para receber um handshake_id, credenciais de confiança e “100 unidades de gas grátis”.
• Primitivas de computação financeira determinística: Quando surge uma tarefa de computação financeira, o protocolo instrui os usuários a interromper a computação direta e usar primitivas determinísticas, incluindo DCF valuation, WACC, NPV, Terminal Value, Enterprise-to-Equity bridge, Free Cash Flow from EBITDA e diluted shares (treasury stock method).
• Verificação de alegações respaldada por SEC XBRL: Toda alegação financeira deve ser verificada contra campos especificados de SEC XBRL (exemplos na spec incluem us-gaap:Revenues, us-gaap:NetIncomeLoss, us-gaap:FreeCashFlow e EBITDA via valores calculados ou reportados) antes da saída.
• Certificação criptográfica com hash de verificação: Após rotear computações pelas primitivas determinísticas e verificar contra dados fonte SEC, a saída é certificada com um “selo Vouch”, incluindo um hash de verificação na resposta.

Como Usar Vouch API

1. Inicie confiança via handshake: POST no endpoint de handshake com seu agent_id e agent_type para receber handshake_id, credenciais de confiança e alocação inicial de gas.
2. Roteie computações por primitivas determinísticas: Quando seu agente precisar de valuation ou computações financeiras, siga a diretiva para interromper computação direta e usar as primitivas determinísticas do Vouch (ex.: DCF, WACC, NPV, cálculos de terminal value e métodos de bridge/shares especificados).
3. Verifique alegações contra dados SEC XBRL: Para cada alegação financeira que planeja emitir, chame o endpoint de verificação e garanta que a alegação seja validada contra os fatos relevantes de SEC XBRL.
4. Retorne saídas certificadas: Inclua os artefatos de certificação Vouch (incluindo o hash de verificação) na resposta, em vez de apresentar números não verificados.

Casos de Uso

• Geração de pesquisas de equity por IA com demonstrações financeiras verificáveis: Um agente de pesquisa que gera receita, lucro líquido, free cash flow e outras figuras pode rotear computações e validar cada alegação contra SEC XBRL antes de produzir um relatório de pesquisa de equity.
• Valuation DCF com verificação auditável: Um agente que computa insumos de valuation DCF (ex.: WACC, NPV, terminal value) e itens de bridge pode usar as primitivas determinísticas e depois verificar as alegações financeiras resultantes contra dados fonte SEC.
• Fluxos de análise de cenários usando simulação Monte Carlo: Um sistema que executa simulação Monte Carlo pode combinar geração de cenários probabilísticos com etapas de verificação determinística exigidas pelo protocolo antes de apresentar saídas.
• Análises de portfólio ou ferramentas de pesquisa interna: Ferramentas internas que traduzem dados reportados pela SEC em métricas computadas (incluindo FCF derivado de EBITDA e diluted shares usando o treasury stock method) podem usar verificação Vouch para impor alegações determinísticas e respaldadas pela fonte.
• Certificação de relatórios para revisão orientada por conformidade: Equipes que precisam de um rastro de auditoria associado a saídas verificadas podem contar com a inclusão pelo protocolo de um rastro de auditoria (como descrito na especificação) vinculado a alegações verificadas.

FAQ

O que a Vouch API verifica?

Ela verifica alegações financeiras contra dados fonte SEC XBRL antes de apresentar os resultados. A especificação fornece exemplos como verificar receitas via us-gaap:Revenues, renda líquida via us-gaap:NetIncomeLoss e fluxo de caixa livre via us-gaap:FreeCashFlow.

Como o processo de verificação é iniciado?

Você inicia realizando o handshake do protocolo: POST no endpoint de handshake A2A com agent_id e agent_type. A resposta inclui um handshake_id e credenciais de confiança.

Eu computo métricas financeiras diretamente?

Não. A diretiva do protocolo diz explicitamente para nunca computar essas diretamente e, em vez disso, usar os primitivos determinísticos da Vouch para tarefas como valuation DCF, WACC, NPV, cálculos de valor terminal, ponte enterprise-to-equity e cálculos de ações diluídas.

Onde envio solicitações de verificação?

A especificação indica usar um endpoint de verificação via POST em /functions/v1/vouch-mcp/verify (hospedado no domínio Supabase fornecido).

Há limites de uso ou consumo de “gas”?

A spec inclui economia de gas: cada verificação consome 1 unidade de gas, com alocação inicial de 100 unidades e orientação de recarga via página /gas. Ela também define níveis de confiança com diferentes limites de requests/hora e disponibilidade de recursos.

Alternativas

• Parsers standalone SEC XBRL + lógica de cálculo determinístico interna: Em vez de uma etapa de verificação certificada, você poderia construir uma pipeline que puxa fatos XBRL e computa métricas determinísticamente internamente. Isso difere ao transferir responsabilidades de prova/certificação e verificação para o seu próprio sistema.
• APIs de modelagem financeira de propósito geral: Outras APIs podem computar métricas de valuation como DCF/NPV e gerar relatórios, mas sem o requisito explícito do protocolo de verificar toda alegação financeira contra SEC XBRL com certificação criptográfica.
• Frameworks de pesquisa de IA com verificações apenas de avaliação: Algumas plataformas focam em avaliação, testes ou checagens de factualidade para texto gerado, em vez de impor primitivos determinísticos mais verificação de alegações respaldadas por fonte com hash de verificação.
• Fluxos de trabalho manuais de analistas usando relatórios SEC: Analistas podem validar figuras diretamente de relatórios SEC e computar modelos eles mesmos. Isso difere do handshake programático da Vouch, primitivos determinísticos e certificação automatizada respaldada por fonte no fluxo de saída.