{
  "id": "roi-calculator",
  "version": "1.0.0",
  "name": "ROI Calculator",
  "shortName": "ROI",
  "description": "Calculate profit, total return, return multiple, and optional annualized return.",
  "category": "Finance",
  "categorySlug": "finance",
  "keywords": [
    "return on investment",
    "investment profit",
    "annualized return",
    "multiple"
  ],
  "status": "live",
  "workStatus": "pending",
  "reviewStatus": "pending",
  "migrationStatus": "new",
  "engine": "native",
  "creator": null,
  "reviewer": null,
  "quality": {
    "availability": "live",
    "technicalReviewRecord": "/reviews/roi-calculator.json",
    "qualifiedReview": "pending",
    "qualifiedReviewer": null,
    "qualifiedReviewDate": null,
    "formulaVersion": "1.0.0",
    "referenceCoverage": "references-pending",
    "releaseTestScope": "Catalog and regression checks are not a professional formula audit; consult release evidence.",
    "historicalMetadataDate": "2026-08-18",
    "historicalMetadataNotice": "The imported date is not evidence of a completed human review."
  },
  "urls": {
    "page": "/calculator/roi-calculator/",
    "definition": "/calculator/roi-calculator/definition.json",
    "schema": "/calculator/roi-calculator/schema.json",
    "llms": "/calculator/roi-calculator/llms.txt",
    "legacyDefinition": "/calculator/roi-calculator.json"
  },
  "queryExample": "https://askcalculators.com/calculator/roi-calculator/?invested=5000&finalValue=7500",
  "queryParameters": {
    "invested": {
      "label": "Amount invested",
      "type": "money",
      "required": true,
      "default": 5000
    },
    "finalValue": {
      "label": "Final value",
      "type": "money",
      "required": true,
      "default": 7500
    },
    "income": {
      "label": "Income received",
      "type": "money",
      "required": false
    },
    "costs": {
      "label": "Extra costs",
      "type": "money",
      "required": false
    },
    "years": {
      "label": "Holding period in years",
      "type": "number",
      "required": false
    }
  },
  "inputs": [
    {
      "id": "invested",
      "label": "Amount invested",
      "type": "money",
      "required": true,
      "defaultValue": 5000,
      "min": 0.01,
      "step": 100,
      "width": "half"
    },
    {
      "id": "finalValue",
      "label": "Final value",
      "type": "money",
      "required": true,
      "defaultValue": 7500,
      "min": 0,
      "step": 100,
      "width": "half"
    },
    {
      "id": "income",
      "label": "Income received",
      "type": "money",
      "min": 0,
      "step": 10,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "costs",
      "label": "Extra costs",
      "type": "money",
      "min": 0,
      "step": 10,
      "help": "Optional",
      "width": "half"
    },
    {
      "id": "years",
      "label": "Holding period in years",
      "type": "number",
      "min": 0.01,
      "max": 100,
      "step": 0.1,
      "help": "Optional; needed for annualized ROI",
      "width": "full"
    }
  ],
  "outputs": [
    {
      "id": "roi",
      "label": "Return on investment",
      "format": "percent",
      "primary": true
    },
    {
      "id": "profit",
      "label": "Net profit",
      "format": "currency"
    },
    {
      "id": "multiple",
      "label": "Return multiple",
      "format": "number",
      "suffix": "×"
    },
    {
      "id": "annualized",
      "label": "Annualized return",
      "format": "percent"
    }
  ],
  "formula": {
    "expression": "ROI = (Ending value + income − investment − costs) ÷ (investment + costs) × 100",
    "note": "Annualized return uses geometric growth and needs a holding period."
  },
  "examples": [
    {
      "label": "Reproducible default-input example (not a personal recommendation)",
      "inputs": {
        "invested": 5000,
        "finalValue": 7500
      }
    }
  ],
  "sources": []
}