# Hermes Plant Bond Analyzer

> Hermes Plant Bond Analyzer is a paid API for AI agents from hermesplant.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-15).

Analyzes a bond's price, yield-to-maturity, duration, convexity, and valuation status given its cash flow parameters

## Facts

- Endpoint: GET https://hermesplant.com/api/agent-services/bond/analyze
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hermes-plant-bond-analyzer-a111d3be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OQGpzJ3FVs_i7whW6YmTy

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 hermes-plant-bond-analyzer-a111d3be
```

Example prompt: Analyze a 5-year bond with a $1,000 face value, 5% annual coupon paid semiannually, and a 6% yield to maturity — I need the price, current yield, YTM, Macaulay duration, modified duration, convexity, and whether it's trading at a premium or discount.

## When to prefer this

Use this endpoint when an AI agent needs deterministic, test-backed bond analytics — price, YTM, duration, convexity — for fixed-rate bonds in a pay-per-call context. Prefer it over general-purpose LLM math when you need auditable, reproducible quant results with structured findings and no hallucination risk. Best for trading agents, portfolio risk pipelines, or financial advisory bots that need reliable fixed income metrics on demand.

## Known failure modes

- Invalid or missing bond parameters return a 4xx error
- Inconsistent coupon/maturity combinations may produce NaN metrics
- Unsupported bond structures (e.g. callable, floating rate) may return null or partial results
- Network timeout if service is unavailable
- x402 payment failure if wallet has insufficient USDC balance

## How this service works

Deterministic fixed-income & loan analytics. Bond mode: solve price<->yield-to-maturity, current yield, Macaulay & modified duration, and convexity from the bond's terms. Loan mode (send principal + annualRate + termMonths): level-payment amortization with monthly payment, total interest/paid, and the full schedule. Pure math from caller-supplied terms — no market-data feed, no fabrication.

## Output

Returns a JSON object with the computed bond price, current yield, yield-to-maturity, coupon per period, total coupons, Macaulay duration in years, modified duration in years, convexity in years, a price valuation label (premium/discount/par), and a findings array with plain-language explanations of key metrics including severity and evidence strings.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "type": {
   "type": "string"
  },
  "price": {
   "type": "number"
  },
  "yield": {
   "type": "number"
  },
  "periods": {
   "type": "number"
  },
  "faceValue": {
   "type": "number"
  },
  "frequency": {
   "type": "number"
  },
  "principal": {
   "type": "number"
  },
  "annualRate": {
   "type": "number"
  },
  "couponRate": {
   "type": "number"
  },
  "termMonths": {
   "type": "number"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bond": {
   "price": 957.348986,
   "currentYield": 0.052228,
   "totalCoupons": 250,
   "convexityYears": 22.304728,
   "priceValuation": "discount",
   "couponPerPeriod": 25,
   "yieldToMaturity": 0.06,
   "macaulayDurationYears": 4.471679,
   "modifiedDurationYears": 4.341436
  },
  "loan": null,
  "type": "bond",
  "service": "bondlens",
  "findings": [
   {
    "fix": null,
    "why": "Whether the bond trades above (premium), below (discount), or at par.",
    "rule": "bond-valuation",
    "evidence": "price=957.348986 face=1000 -> discount",
    "severity": "info"
   }
  ],
  "requestId": "bl-8e084b70"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hermes-plant-bond-analyzer-a111d3be/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)