APIs › Business & Financial Calculators › NPV & IRR

NPV & IRR

Computes NPV, IRR, MIRR, payback and discounted payback from a cash-flow series, using bracketed bisection so IRR either converges or says it did not.

POST /v1/business/npv-irr $0.02 per call

Specification

Endpoint

POST /v1/business/npv-irr

Price

$0.02 per call · tier advanced_analysis

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · scheme exact

Data source

Deterministic decimal arithmetic on caller-supplied input

Timeout

15 seconds

Max request

256 KB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/business/npv-irr" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "npv": "29078.68",
  "discount_rate_percent": "10",
  "irr_percent": "19.7111",
  "irr_converged": true,
  "irr_method": "bracketed bisection over -0.9999 to 100",
  "mirr_percent": "15.7614",
  "payback_period_years": "3.25",
  "discounted_payback_period_years": "3.96",
  "profitability_index": "1.2908",
  "sign_changes": 1,
  "period_count": 5,
  "decision_hint": "NPV is positive at the supplied discount rate."
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints