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 — calculates return on investment from an initial investment plus final value or net profit
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
Calculates return on investment from an initial investment plus final value or net profit. Returns ROI percent, annualized return, money multiple, score, drivers, and recommendation. Use it as an ROI calculator API, CAGR calculator, or money multiple calculator.
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 |
|---|---|---|
| accounts-receivable-aging-score | Scores the health of an accounts receivable book from its aging profile, returning a weighted score and grade. | $0.01 |
| amortization-schedule | Computes a loan's amortization schedule and payment breakdown. | $0.01 |
| asset-based-lending-score | Scores the risk of an asset based lending (ABL) facility, returning a weighted score and grade. | $0.01 |
| blended-finance-score | Scores a blended finance structure on how efficiently concessional capital mobilizes private money, returning a 0-100 structure score. | $0.01 |
| blended-finance-score-api | Scores blended finance structures on concessional capital leverage. | $0.01 |
| break-even-calculator | Calculates break-even units and contribution margin for a product's unit economics. | $0.01 |
| cash-conversion-cycle-calculator | Calculates the cash conversion cycle for working capital optimization. | $0.01 |
| cash-runway-calculator | Calculates a startup's cash runway from its monthly burn. | $0.01 |
SEE ALSO