Investment Return Calculator: API and MCP

Investment Return Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: finance.investment-return
Version: 1.0.0
Access: Free
Tool page: Investment Return Calculator
Schema: GET /api/v1/tools/finance.investment-return

Input

Field	Type	Constraints	Default	Description
`initialValue` (required)	number	> 0, ≤ 1,000,000,000,000		Initial value · Purchase amount plus costs. Use the same currency for both values.
`finalValue` (required)	number	≥ 0, ≤ 1,000,000,000,000		Final value · Sale amount or current value.
`years`	number	≥ 0, ≤ 100	0	Years
`months`	number	≥ 0, ≤ 1,200	0	Months
`days`	number	≥ 0, ≤ 36,500	0	Days

Output

Field	Type	Description
`annualizedReturn`	number	Annualized return (CAGR) (%)
`totalReturn`	number	Total return (%)
`profit`	number	Profit or loss
`termYears`	number	Holding period (years)

Example request

{
  "input": {
    "initialValue": 100000,
    "finalValue": 150000,
    "years": 3,
    "months": 0,
    "days": 0
  },
  "locale": "en"
}

Example answer

{
  "output": {
    "annualizedReturn": 14.471424255333186,
    "totalReturn": 50,
    "profit": 50000,
    "termYears": 3
  },
  "steps": [
    {
      "id": "termYears",
      "formula": "t = years + months/12 + days/365",
      "substitution": "t = 3 + 0/12 + 0/365",
      "value": 3,
      "unit": "years"
    },
    {
      "id": "profit",
      "formula": "profit = final value − initial value",
      "substitution": "profit = 150,000 − 100,000",
      "value": 50000
    },
    {
      "id": "totalReturn",
      "formula": "total return = (final value − initial value) / initial value × 100",
      "substitution": "total return = (150,000 − 100,000) / 100,000 × 100",
      "value": 50,
      "unit": "%"
    },
    {
      "id": "annualizedReturn",
      "formula": "annualized return = ((final value / initial value)^(1/t) − 1) × 100",
      "substitution": "annualized return = ((150,000 / 100,000)^(1/3) − 1) × 100",
      "value": 14.471424255333186,
      "unit": "%"
    }
  ],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/finance/investment-return-calculator",
    "title": "Investment Return Calculator"
  }
}