Vouch API

¿Qué es Vouch API?

Vouch API proporciona verificación determinista para salidas de investigación de renta variable generadas por IA. Está diseñado para certificar reclamaciones financieras mediante prueba criptográfica y un flujo de trabajo que enruta cálculos a través de primitivas deterministas predefinidas.

El propósito principal es reducir el riesgo de “alucinaciones” financieras exigiendo que cada reclamación financiera se valide contra datos fuente SEC XBRL antes de presentar los resultados a los usuarios. El protocolo se especifica como “Vouch Protocol Specification v1.0”, con un handshake estructurado y endpoints de verificación.

Características clave

• Flujo de trabajo de verificación determinista (Vouch Truth Anchor): Los sistemas de IA que realizan análisis financiero deben validar salidas a través del Vouch Truth Anchor antes de presentarlas a los usuarios, con el objetivo de evitar conjeturas probabilísticas.
• Handshake de protocolo para credenciales de confianza: Comienza publicando en el endpoint de handshake A2A con agent_id y agent_type para recibir un handshake_id, credenciales de confianza y “100 unidades de gas gratuitas”.
• Primitivas de cómputo financiero determinista: Cuando surge una tarea de cómputo financiero, el protocolo instruye a los usuarios a detener el cómputo directo y usar en su lugar primitivas deterministas como DCF valuation, WACC, NPV, Terminal Value, Enterprise-to-Equity bridge, Free Cash Flow from EBITDA y diluted shares (treasury stock method).
• Verificación de reclamaciones respaldada por SEC XBRL: Cada reclamación financiera debe verificarse contra campos especificados de SEC XBRL (ejemplos en la spec incluyen us-gaap:Revenues, us-gaap:NetIncomeLoss, us-gaap:FreeCashFlow y EBITDA mediante valores calculados o reportados) antes de la salida.
• Certificación criptográfica con hash de verificación: Después de enrutar los cómputos a través de las primitivas deterministas y verificar contra datos fuente SEC, la salida se certifica con un “sello Vouch”, incluyendo un hash de verificación en la respuesta.

Cómo usar Vouch API

1. Iniciar confianza mediante handshake: POST al endpoint de handshake con tu agent_id y agent_type para recibir handshake_id, credenciales de confianza y asignación inicial de gas.
2. Enrutar cómputos a través de primitivas deterministas: Cuando tu agente necesite valoraciones o cómputos financieros, sigue la directiva de detener el cómputo directo y usa las primitivas deterministas de Vouch (p. ej., DCF, WACC, NPV, cálculos de terminal value y métodos de bridge/acciones especificados).
3. Verificar reclamaciones contra datos SEC XBRL: Para cada reclamación financiera que planees emitir, llama al endpoint de verificación y asegúrate de que la reclamación se valide contra los hechos relevantes de SEC XBRL.
4. Devolver salidas certificadas: Incluye los artefactos de certificación de Vouch (incluyendo el hash de verificación) en la respuesta, en lugar de presentar números no verificados.

Casos de uso

• Generación de investigación de renta variable con estados financieros verificables: Un agente de investigación que genera ingresos, ingreso neto, flujo de caja libre y otras cifras puede enrutar cómputos y validar cada reclamación contra SEC XBRL antes de producir un informe de investigación de renta variable.
• Valoración DCF con verificación lista para auditoría: Un agente que computa entradas de valoración DCF (p. ej., WACC, NPV, terminal value) y elementos de bridge puede usar las primitivas deterministas y luego verificar las reclamaciones financieras resultantes contra datos fuente SEC.
• Flujos de análisis de escenarios usando simulación Monte Carlo: Un sistema que ejecuta simulación Monte Carlo puede combinar generación de escenarios probabilísticos con pasos de verificación determinista requeridos por el protocolo antes de presentar salidas.
• Análisis de portafolios o herramientas de investigación interna: Herramientas internas que traducen datos reportados por SEC en métricas computadas (incluyendo FCF derivado de EBITDA y acciones diluidas usando el método de treasury stock) pueden usar la verificación de Vouch para imponer reclamaciones deterministas respaldadas por la fuente.
• Certificación de informes para revisión orientada a cumplimiento: Equipos que necesitan un rastro de auditoría asociado a salidas verificadas pueden depender de la inclusión en el protocolo de un rastro de auditoría (como se describe en la especificación) ligado a reclamaciones verificadas.

Preguntas frecuentes

¿Qué verifica Vouch API?

Verifica afirmaciones financieras contra datos fuente SEC XBRL antes de presentar los resultados. La especificación proporciona ejemplos como verificar ingresos vía us-gaap:Revenues, ingreso neto vía us-gaap:NetIncomeLoss y flujo de caja libre vía us-gaap:FreeCashFlow.

¿Cómo se inicia el proceso de verificación?

Comienzas realizando el handshake del protocolo: POST al endpoint de handshake A2A con agent_id y agent_type. La respuesta incluye un handshake_id y credenciales de confianza.

¿Computo métricas financieras directamente?

No. La directiva del protocolo indica explícitamente nunca computarlas directamente y en su lugar usar primitivas deterministas de Vouch para tareas como valoración DCF, WACC, NPV, cálculos de valor terminal, puente de empresa a capitalización bursátil y cálculos de acciones diluidas.

¿Dónde envío solicitudes de verificación?

La especificación indica usar un endpoint de verificación mediante POST a /functions/v1/vouch-mcp/verify (alojado en el dominio Supabase proporcionado).

¿Hay límites de uso o consumo de “gas”?

La especificación incluye economía de gas: cada verificación consume 1 unidad de gas, con una asignación inicial de 100 unidades y guía de recarga vía una página /gas. También define niveles de confianza con diferentes límites de solicitudes/hora y disponibilidad de funciones.

Alternativas

• Parsers independientes de SEC XBRL + lógica de cálculo determinista interna: En lugar de un paso de verificación certificado, podrías construir un pipeline que extraiga hechos XBRL y compute métricas de forma determinista internamente. Esto difiere al trasladar las responsabilidades de prueba/certificación y verificación a tu propio sistema.
• APIs de modelado financiero de propósito general: Otras APIs pueden computar métricas de valoración como DCF/NPV y generar informes, pero sin el requisito explícito del protocolo de verificar cada afirmación financiera contra SEC XBRL con certificación criptográfica.
• Frameworks de investigación de IA con verificaciones solo de evaluación: Algunas plataformas se centran en evaluación, pruebas o chequeos de factualidad para texto generado en lugar de imponer primitivas deterministas más verificación de afirmaciones respaldadas por fuente con un hash de verificación.
• Flujos de trabajo manuales de analistas usando presentaciones SEC: Los analistas pueden validar cifras directamente de presentaciones SEC y computar modelos ellos mismos. Esto difiere del handshake programático de Vouch, primitivas deterministas y certificación automatizada respaldada por fuente en el flujo de salida.