---
title: "Investment Calculator"
method: POST
path: "/api/v1/tools/investment-calculator"
tags: ["tools"]
---

# Investment Calculator

`POST /api/v1/tools/investment-calculator`

## Request

- Base URL: `https://toolforte.com`
- URL: `https://toolforte.com/api/v1/tools/investment-calculator`
- Auth: HTTP bearer

Project a lump sum plus a monthly contribution at a yearly return, compounded monthly with the contribution going in at the start of each month. Returns the final value, everything paid in, the growth, and a year-by-year table of balance and growth.

## Request body

- object
  - `initialInvestment` integer
  - `monthlyContribution` integer
  - `annualReturnPercent` integer
  - `years` integer

## Response `200`

Successful result

- object
  - `ok` boolean
  - `data` object
    - `initialInvestment` integer
    - `monthlyContribution` integer
    - `annualReturnPercent` integer
    - `years` integer
    - `finalValue` number
    - `totalContributed` integer
    - `totalGrowth` number
    - `growthPercent` integer
    - `yearlyBreakdown` object[]
      - `year` integer
      - `contributed` integer
      - `growth` number
      - `balance` number

## Other responses

- `400`: Missing or invalid request fields
- `401`: Invalid or missing API key
- `429`: Monthly plan limit reached

---

[API](https://skmtc.dev/toolforte/apis/toolforte-api.md) · [All operations](https://skmtc.dev/toolforte/apis/toolforte-api/llms.txt) · [OpenAPI document](https://skmtc.dev/toolforte/apis/toolforte-api/revisions/4d814d484dfc?raw)