Calculators

ROI & annualized ROI calculator API

Return on investment = (gain - cost) / cost, plus annualized ROI = (gain/cost)^(1/years) - 1 when a holding period is given — auditable with a net-profit breakdown and rating. Answers 'what's my ROI', 'what's the annualized return', 'was this investment a loss'.

Price$0.01per request

MethodPOST

Route/v1/calc/biz-roi

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

calcroireturninvestmentannualizedfinanceprofitops

API URLhttps://x402.hexl.dev/v1/calc/biz-roi

Integration docs

Example request

{
  "gain": 15000,
  "cost": 10000,
  "years": 3
}

Example response

{
  "formula": "roi = (gain - cost) / cost",
  "netProfit": 5000,
  "roi": 0.5,
  "roiPercent": 50,
  "rating": "good",
  "inputs": {
    "gain": 15000,
    "cost": 10000
  },
  "years": 3,
  "annualizedRoi": 0.1447,
  "annualizedRoiPercent": 14.47
}

Input schema

{
  "type": "object",
  "required": [
    "gain",
    "cost"
  ],
  "properties": {
    "gain": {
      "type": "number",
      "examples": [
        15000
      ]
    },
    "cost": {
      "type": "number",
      "examples": [
        10000
      ]
    },
    "years": {
      "type": "number",
      "examples": [
        3
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}