Vouch API

Vouch API란?

Vouch API는 AI 생성 주식 연구 출력물에 대한 결정적 검증을 제공합니다. 암호학적 증명과 미리 정의된 결정적 기본 요소를 통해 계산을 라우팅하는 워크플로를 사용해 금융 주장을 인증하도록 설계되었습니다.

핵심 목적은 모든 금융 주장이 사용자에게 결과를 제시하기 전에 SEC XBRL 소스 데이터로 검증되도록 요구함으로써 금융 “환각” 위험을 줄이는 것입니다. 프로토콜은 “Vouch Protocol Specification v1.0”으로 지정되며, 구조화된 핸드셰이크와 검증 엔드포인트를 포함합니다.

주요 기능

결정적 검증 워크플로 (Vouch Truth Anchor): 금융 분석을 수행하는 AI 시스템은 사용자에게 제시하기 전에 Vouch Truth Anchor를 통해 출력을 검증해야 하며, 확률적 추측을 피하는 것을 목표로 합니다.
신뢰 자격 증명 프로토콜 핸드셰이크: agent_id와 agent_type으로 A2A 핸드셰이크 엔드포인트에 POST하여 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”를 적용하며 응답에 검증 해시를 포함합니다.

Vouch API 사용 방법

핸드셰이크로 신뢰 시작: agent_id와 agent_type으로 핸드셰이크 엔드포인트에 POST하여 handshake_id, 신뢰 자격 증명 및 초기 가스 할당을 받습니다.
결정적 기본 요소로 계산 라우팅: 에이전트가 밸류에이션이나 금융 계산이 필요할 때 직접 계산을 중단하고 Vouch 결정적 기본 요소(DCF, WACC, NPV, terminal value 계산, 지정된 bridge/share 방법 등)를 사용합니다.
SEC XBRL 데이터로 주장 검증: 출력할 각 금융 주장에 대해 검증 엔드포인트를 호출하고 관련 SEC XBRL 사실로 주장이 검증되는지 확인합니다.
인증된 출력 반환: 검증되지 않은 숫자를 제시하는 대신 응답에 Vouch 인증 아티팩트(검증 해시 포함)를 포함합니다.

사용 사례

검증 가능한 재무제표를 사용한 AI 주식 연구 생성: 수익, 순이익, 자유현금흐름 등 수치를 생성하는 연구 에이전트가 계산을 라우팅하고 각 주장을 SEC XBRL로 검증한 후 주식 연구 보고서를 생성할 수 있습니다.
감사 준비 검증이 포함된 DCF 밸류에이션: WACC, NPV, terminal value 등의 DCF 밸류에이션 입력과 bridge 항목을 계산하는 에이전트가 결정적 기본 요소를 사용한 후 결과 금융 주장을 SEC 소스 데이터로 검증할 수 있습니다.
몬테카를로 시뮬레이션을 사용한 시나리오 분석 워크플로: 몬테카를로 시뮬레이션을 실행하는 시스템이 확률적 시나리오 생성을 프로토콜이 요구하는 결정적 검증 단계와 결합하여 출력을 제시할 수 있습니다.
포트폴리오 분석 또는 내부 연구 도구: SEC 보고 데이터를 계산 지표(EBITDA 유도 FCF, treasury stock method를 사용한 희석 주식 포함)로 변환하는 내부 도구가 Vouch 검증을 사용해 결정적, 소스 기반 주장을 강제할 수 있습니다.
컴플라이언스 지향 검토를 위한 보고서 인증: 검증된 출력과 연계된 감사 추적을 필요로 하는 팀이 스펙에 설명된 대로 검증된 주장과 연결된 프로토콜의 감사 추적에 의존할 수 있습니다.

자주 묻는 질문

Vouch API는 무엇을 검증하나요?

결과가 제시되기 전에 SEC XBRL 소스 데이터로 금융 주장을 검증합니다. 명세서에는 us-gaap:Revenues를 통한 매출 검증, us-gaap:NetIncomeLoss를 통한 순이익 검증, us-gaap:FreeCashFlow를 통한 자유현금흐름 검증 등의 예시가 있습니다.

검증 프로세스는 어떻게 시작하나요?

프로토콜 핸드셰이크를 수행하는 것으로 시작합니다: agent_id와 agent_type을 포함해 A2A 핸드셰이크 엔드포인트에 POST합니다. 응답에는 handshake_id와 신뢰 자격 증명이 포함됩니다.

재무 지표를 직접 계산하나요?

아니요. 프로토콜 지침은 절대 직접 계산하지 말라고 명시하며, DCF 가치 평가, WACC, NPV, 종단 가치 계산, 기업 가치-자본 브릿지, 희석 주식 계산 등의 작업에 Vouch 결정적 프리미티브를 사용하라고 합니다.

검증 요청은 어디로 보내나요?

명세서에 따라 제공된 Supabase 도메인에 호스팅된 /functions/v1/vouch-mcp/verify에 POST합니다.

사용 제한이나 “gas” 소비가 있나요?

명세서에 gas 경제학이 포함되어 있습니다: 각 검증은 1 gas 유닛을 소비하며, 초기 할당은 100 유닛이고 /gas 페이지로 리필 지침을 제공합니다. 또한 요청/시간과 기능 가용성이 다른 신뢰 수준을 정의합니다.

대안

독립형 SEC XBRL 파서 + 사내 결정적 계산 로직: 인증된 검증 단계 대신 XBRL 사실을 가져와 내부적으로 지표를 결정적으로 계산하는 파이프라인을 구축할 수 있습니다. 이는 증명/인증 및 검증 책임을 자체 시스템으로 이전하는 점에서 다릅니다.
범용 재무 모델링 API: 다른 API는 DCF/NPV 같은 가치 평가 지표를 계산하고 보고서를 생성할 수 있지만, SEC XBRL로 모든 금융 주장을 암호학적 인증으로 검증하라는 명시적 프로토콜 요구사항이 없습니다.
평가 전용 체크를 가진 AI 연구 프레임워크: 일부 플랫폼은 생성된 텍스트의 평가, 테스트, 사실성 체크에 초점을 맞추지만, 결정적 프리미티브와 소스 기반 주장 검증(검증 해시 포함)을 강제하지 않습니다.
SEC 제출 서류를 사용하는 수동 분석가 워크플로: 분석가는 SEC 제출 서류에서 수치를 직접 검증하고 모델을 계산할 수 있습니다. 이는 Vouch의 프로그래매틱 핸드셰이크, 결정적 프리미티브, 출력 워크플로의 자동 소스 기반 인증과 다릅니다.