# x402toll Bond Yield Calculator

> x402toll Bond Yield Calculator is a paid API for AI agents from x402toll.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Calculates current yield and yield-to-maturity for a bond given face value, coupon rate, market price, and maturity, and classifies it as trading at a premium, discount, or par.

## Facts

- Endpoint: POST https://x402toll.com/v1/investing/bond-yield
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402toll-bond-yield-calculator-a3964623
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Bk_DjEwGwLAJaPUnt9u4H

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 x402toll-bond-yield-calculator-a3964623 -d '<json body>'
```

Example prompt: Calculate the yield to maturity and current yield for a bond with a $1,000 face value, 6% annual coupon rate paid semi-annually, currently priced at $920, with 8 years left to maturity — and tell me whether it's trading at a premium, discount, or par.

## When to prefer this

Use this endpoint when you need a precise, formula-based bond yield computation including both current yield and YTM with a premium/discount/par classification — especially when building financial tools, answering investor questions about fixed income returns, or evaluating whether a bond is fairly priced relative to its face value.

## Known failure modes

- Missing required fields (price, couponRatePct, yearsToMaturity) returns a validation error
- yearsToMaturity below 0.5 or above 100 rejected as out of range
- couponRatePct outside 0–100 range returns validation error
- Non-numeric inputs for numeric fields cause a 400 error
- Insufficient USDC payment (< $0.05) causes a 402 Payment Required response

## How this service works

Bond current yield and yield-to-maturity from face value, coupon, market price, and maturity — with the premium/discount/par classification.

## Output

Returns the bond's current yield (annual coupon divided by market price), yield-to-maturity (annualized total return if held to maturity), and a classification of whether the bond is trading at a premium (price above face value), discount (price below face value), or par (price equals face value).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "price": {
   "type": "number"
  },
  "faceValue": {
   "type": "number",
   "default": 1000
  },
  "couponRatePct": {
   "type": "number",
   "maximum": 100,
   "minimum": 0
  },
  "paymentsPerYear": {
   "type": "number",
   "default": 2
  },
  "yearsToMaturity": {
   "type": "number",
   "maximum": 100,
   "minimum": 0.5
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402toll-bond-yield-calculator-a3964623/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402toll.com](https://www.zero.xyz/host/x402toll.com/llms.txt)