Vouch API

Was ist Vouch API?

Vouch API bietet deterministische Verifikation für KI-generierte Equity-Research-Ausgaben. Sie ist darauf ausgelegt, Finanzangaben mit kryptografischem Beweis und einem Workflow zu zertifizieren, der Berechnungen durch vordefinierte deterministische Primitiven leitet.

Der Kernzweck ist es, das Risiko finanzieller „Halluzinationen“ zu reduzieren, indem jede Finanzangabe vor der Präsentation an Nutzer gegen SEC XBRL-Quellendaten validiert wird. Das Protokoll ist als „Vouch Protocol Specification v1.0“ spezifiziert, mit strukturiertem Handshake und Verifikationsendpunkten.

Wichtige Funktionen

• Deterministischer Verifikationsworkflow (Vouch Truth Anchor): KI-Systeme, die Finanzanalysen durchführen, müssen Ausgaben über den Vouch Truth Anchor validieren, bevor sie an Nutzer präsentiert werden, um probabilistische Schätzungen zu vermeiden.
• Protokoll-Handshake für Vertrauenszertifikate: Beginnen Sie mit einem POST zum A2A-Handshake-Endpunkt mit agent_id und agent_type, um handshake_id, Vertrauenszertifikate und „100 free gas units“ zu erhalten.
• Deterministische Finanzberechnungsprimitiven: Bei einer Finanzberechnungsaufgabe weist das Protokoll an, direkte Berechnungen zu stoppen und stattdessen deterministische Primitiven zu nutzen, einschließlich DCF valuation, WACC, NPV, Terminal Value, Enterprise-to-Equity bridge, Free Cash Flow from EBITDA und diluted shares (treasury stock method).
• SEC XBRL-gestützte Anspruchsverifikation: Jede Finanzangabe muss gegen spezifizierte SEC XBRL-Felder verifiziert werden (Beispiele in der Spezifikation umfassen us-gaap:Revenues, us-gaap:NetIncomeLoss, us-gaap:FreeCashFlow und EBITDA über berechnete oder gemeldete Werte), bevor sie ausgegeben wird.
• Kryptografische Zertifizierung mit Verifikations-Hash: Nach Leitung der Berechnungen durch deterministische Primitiven und Verifikation gegen SEC-Quellendaten wird die Ausgabe mit einem „Vouch stamp“ zertifiziert, inklusive Verifikations-Hash in der Response.

So verwenden Sie Vouch API

1. Vertrauen per Handshake initiieren: POST zum Handshake-Endpunkt mit Ihrer agent_id und agent_type, um handshake_id, Vertrauenszertifikate und anfängliche Gas-Zuweisung zu erhalten.
2. Berechnungen durch deterministische Primitiven leiten: Wenn Ihr Agent Bewertungen oder Finanzberechnungen benötigt, folgen Sie der Anweisung, direkte Berechnungen zu stoppen und die deterministischen Vouch-Primitiven zu nutzen (z. B. DCF, WACC, NPV, Terminal-Value-Berechnungen und spezifizierte Bridge-/Aktienmethoden).
3. Ansprüche gegen SEC XBRL-Daten verifizieren: Für jede zu ausgebende Finanzangabe rufen Sie den Verifikationsendpunkt auf und stellen sicher, dass der Anspruch gegen die relevanten SEC XBRL-Fakten validiert wird.
4. Zertifizierte Ausgaben zurückgeben: Fügen Sie die Vouch-Zertifizierungsartefakte (inklusive Verifikations-Hash) in die Response ein, anstatt unverificierte Zahlen zu präsentieren.

Anwendungsfälle

• KI-generierte Equity-Research mit verifizierbaren Finanzkennzahlen: Ein Research-Agent, der Umsatz, Nettoeinkommen, Free Cash Flow und andere Kennzahlen erzeugt, kann Berechnungen leiten und jeden Anspruch gegen SEC XBRL validieren, bevor er einen Equity-Research-Report produziert.
• DCF-Bewertung mit auditierfähiger Verifikation: Ein Agent, der DCF-Bewertungseingaben (z. B. WACC, NPV, Terminal Value) und Bridge-Elemente berechnet, kann deterministische Primitiven nutzen und die resultierenden Finanzangaben gegen SEC-Quellendaten verifizieren.
• Szenarioanalysen mit Monte-Carlo-Simulation: Ein System, das Monte-Carlo-Simulationen durchführt, kann probabilistische Szenariogenerierung mit den vom Protokoll geforderten deterministischen Verifikationsschritten kombinieren, bevor Ausgaben präsentiert werden.
• Portfolio-Analytics oder interne Research-Tools: Interne Tools, die SEC-gemeldete Daten in berechnete Metriken umwandeln (inklusive EBITDA-abgeleitetem FCF und diluted shares per Treasury-Stock-Methode), können Vouch-Verifikation nutzen, um deterministische, quellengestützte Ansprüche durchzusetzen.
• Report-Zertifizierung für compliance-orientierte Überprüfung: Teams, die einen Audit-Trail für verifizierte Ausgaben benötigen, können auf den im Protokoll enthaltenen Audit-Trail (wie in der Spezifikation beschrieben) setzen, der an verifizierte Ansprüche gebunden ist.

FAQ

Was verifiziert die Vouch API?

Sie verifiziert Finanzangaben gegen SEC XBRL-Quellendaten, bevor Ergebnisse präsentiert werden. Die Spezifikation enthält Beispiele wie die Verifikation von Umsätzen via us-gaap:Revenues, Nettogewinn via us-gaap:NetIncomeLoss und Free Cash Flow via us-gaap:FreeCashFlow.

Wie startet der Verifikationsprozess?

Sie beginnen mit dem Protokoll-Handshake: POST an den A2A-Handshake-Endpunkt mit agent_id und agent_type. Die Antwort enthält eine handshake_id und Vertrauenszertifikate.

Berechne ich Finanzkennzahlen direkt?

Nein. Die Protokollrichtlinie fordert ausdrücklich, diese niemals direkt zu berechnen, sondern stattdessen Vouch-deterministische Primitiven für Aufgaben wie DCF-Bewertung, WACC, NPV, Terminalwert-Berechnungen, Enterprise-to-Equity-Bridge und verwässerte Aktienberechnungen zu nutzen.

Wohin sende ich Verifikationsanfragen?

Die Spezifikation gibt einen Verifikations-Endpunkt an: POST an /functions/v1/vouch-mcp/verify (gehostet auf der angegebenen Supabase-Domäne).

Gibt es Nutzungsbeschränkungen oder „Gas“-Verbrauch?

Die Spezifikation umfasst Gas-Ökonomie: Jede Verifikation verbraucht 1 Gas-Einheit, mit einer anfänglichen Zuweisung von 100 Einheiten und Nachfüllhinweisen über eine /gas-Seite. Sie definiert zudem Vertrauensstufen mit unterschiedlichen Anfragen/Stunde und Feature-Verfügbarkeit.

Alternativen

• Standalone SEC XBRL Parser + interne deterministische Berechnungslogik: Statt eines zertifizierten Verifikationsschritts könnten Sie eine Pipeline bauen, die XBRL-Fakten abruft und Kennzahlen intern deterministisch berechnet. Dies unterscheidet sich durch die Verschiebung von Beweis/Zertifizierung und Verifikationsverantwortung in Ihr eigenes System.
• Allgemeine Finanzmodellierungs-APIs: Andere APIs berechnen Bewertungskennzahlen wie DCF/NPV und erzeugen Berichte, jedoch ohne die explizite Protokollpflicht, jede Finanzangabe gegen SEC XBRL mit kryptografischer Zertifizierung zu verifizieren.
• KI-Research-Frameworks mit nur Evaluationsprüfungen: Einige Plattformen konzentrieren sich auf Evaluation, Tests oder Faktentreueprüfungen für generierten Text, statt deterministische Primitiven plus quellengestützte Anspruchsverifikation mit Verifikations-Hash durchzusetzen.
• Manuelle Analysten-Workflows mit SEC-Filings: Analysten können Zahlen direkt aus SEC-Filings validieren und Modelle selbst berechnen. Dies unterscheidet sich von Vouchs programmatischem Handshake, deterministischen Primitiven und automatisierter quellengestützter Zertifizierung im Ausgabe-Workflow.