APIs › Business & Financial Calculators › ROI Calculator

ROI Calculator

Computes simple ROI, annualised ROI and CAGR from cash flows with the holding period stated.

POST /v1/business/roi $0.005 per call

Specification

Endpoint

POST /v1/business/roi

Price

$0.005 per call · tier basic_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · schemes exact, aggr_deferred

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/roi" \
  -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.

{
  "total_invested": "53000.00",
  "initial_investment": "50000.00",
  "additional_costs": "3000.00",
  "final_value": "78000.00",
  "net_gain": "25000.00",
  "simple_roi_percent": "47.1698",
  "annualised_roi_percent": "16.7152",
  "cagr_percent": "16.7152",
  "holding_period_years": "2.5",
  "note": "Annualised ROI and CAGR coincide for a single-entry, single-exit position; they diverge once there are interim cash flows, which /v1/business/npv-irr handles."
}

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