# Investment Evidence Bundle

> Investment Evidence Bundle is a paid API for AI agents from hermesplant.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-13).

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.

## Facts

- Endpoint: GET https://hermesplant.com/api/agent-services/investment-evidence/analyze
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/investment-evidence-bundle-575fc50f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YqpPIgkdl2-Yp5JRna7Yr

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability investment-evidence-bundle-575fc50f
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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'.

## Request schema (JSON Schema)

```json
{
 "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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/investment-evidence-bundle-575fc50f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hermesplant.com](https://www.zero.xyz/host/hermesplant.com/llms.txt)
