agentutility(7)$ man roi-calculator
/roi-calculator
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgefinanceCATEGORY
uncategorized
STATUS
● live
NAME
roi-calculator — roi calculator api / return on investment / cagr / money multiple calculator
SYNOPSIS
POST https://x402.agentutility.ai/roi-calculator
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
ROI calculator API / return on investment / CAGR / money multiple calculator. Takes initial investment plus final value or net profit and returns ROI percent, annualized return, money multiple, score, drivers, and recommendation. Pure deterministic finance math, no upstream API.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| initial_investment | number | Initial invested capital. | required |
| final_value | number | Ending value. Optional if net_profit is supplied. | optional |
| net_profit | number | Net profit. Optional if final_value is supplied. | optional |
| years | number | Holding period in years. Default 1. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| calculator | string | — |
| score | string | — |
| grade | string | — |
| recommendation | string | — |
| metrics | string | — |
| drivers | string | — |
| warnings | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/roi-calculator \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the roi-calculator tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- edge-financeroicalculatorroi-calculator
- methods
- POST
- cluster
- edgefinance
- price
- $0.01 USDC per call
ADJACENT — other endpoints in edgefinance
| endpoint | description | price |
|---|---|---|
| blended-finance-score | Blended finance score API / concessional capital efficiency / private capital mobilization / first-loss impact finance calculator. | $0.01 |
| blended-finance-score-api | Blended finance score API / concessional capital leverage scoring / impact finance risk score. | $0.01 |
| blended-finance-score-api-f70b81 | Blended finance score API / concessional capital efficiency / private-capital leverage and impact score. | $0.01 |
| break-even-calculator | Break-even calculator API / contribution margin calculator / unit economics break-even units / fixed cost payback. | $0.01 |
| dcf-valuation-calculator | DCF valuation calculator API / discounted cash flow / enterprise value / equity value / value per share calculator. | $0.01 |
| edgar-filings | EDGAR filings lookup / SEC EDGAR API / public company filing fetcher. | $0.01 |
| embedded-finance-score | Embedded finance score API / fintech integration quality / compliance KYC uptime conversion chargeback score. | $0.01 |
| embedded-finance-score-api | Embedded finance score API / fintech integration scoring / compliance and conversion lift scoring. | $0.01 |
SEE ALSO