{"uid":"cap_YqpPIgkdl2-Yp5JRna7Yr","slug":"investment-evidence-bundle-575fc50f","name":"Investment Evidence Bundle","description":"CashflowLens return and DCF analytics plus PortfolioGuard concentration and risk scoring in one paid call, with structured internal evidence and a tamper-evident signed receipt. Pure math from caller-provided cashflows, holdings, and returns; no market-data feed and no claim that inputs are independently verified.","url":"https://hermesplant.com/api/agent-services/investment-evidence/analyze","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"runId":{"type":"string","description":"Optional caller run or deal identifier."},"cashflow":{"type":"object","description":"CashflowLens input: cashflows plus optional discount rate, DCF, NAV, and periods per year."},"portfolio":{"type":"object","description":"PortfolioGuard input: holdings plus optional portfolio or holding return series and risk-free rate."}}},"responseSchema":{"type":"json","example":{"status":"analyzed","receipt":{"algorithm":"HMAC-SHA-256","verifyUrl":"https://hermesplant.com/api/receipts/verify"},"service":"investment-evidence","cashflow":{"service":"cashflowlens","summary":{"npv":162512.34,"moic":1.38,"irrAnnual":0.1287}},"evidence":{"decision":"verified","verified":true},"portfolio":{"metrics":{"concentrationHHI":0.52,"diversificationScore":48},"riskLevel":"low","riskScore":24},"recommendedAction":"persist_signed_analysis"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3dQAA3hHi6DjheiK-KNnd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a deterministic safety gate on consequential agent actions and produces machine-readable investment analysis evidence with signed receipts, NPV/MOIC/IRR metrics, and portfolio risk scores.","exampleAgentPrompt":"Before finalizing this investment action, run it through the Investment Evidence Bundle safety gate — analyze the cashflow, compute NPV/MOIC/IRR, score the portfolio risk, and give me back a signed HMAC receipt I can use to verify the decision was properly reviewed.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing: analysis status ('analyzed'), a signed HMAC-SHA-256 receipt with a verifyUrl, cashflow metrics (NPV, MOIC, annualized IRR) from CashflowLens, evidence verdict (verified true/false and decision label), portfolio risk metrics (HHI concentration, diversification score, risk level and score), and a recommended action string such as 'persist_signed_analysis'.","failureModes":["Invalid or missing investment payload returns 400 with validation error","Insufficient USDC balance or x402 payment failure blocks the gate and returns 402","Malformed cashflow data causes CashflowLens sub-service to return error, propagated in response","Network timeout to hermesplant.com returns 503 or connection error","Receipt verification URL unavailable makes post-hoc audit impossible"],"whenToPreferThis":"Use this endpoint when an AI agent is about to take a consequential financial, infrastructure, or deployment action and you need both a deterministic safety gate and a machine-readable, cryptographically signed evidence trail. It is especially appropriate when you need NPV/MOIC/IRR cashflow analysis combined with portfolio risk scoring (HHI, diversification) in a single call, and when regulatory or audit requirements demand a verifiable receipt. Prefer this over a simple risk-check API when you need the full evidence bundle with a signed verifyUrl.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:37:31.232Z","isFirstParty":false}