---
title: "Compound interest calculator"
method: GET
path: "/api/v1/calculators/compound-interest"
tags: ["Calculators"]
---

# Compound interest calculator

`GET /api/v1/calculators/compound-interest`

Pure math — no market data. Note that the rate applies PER COMPOUNDING PERIOD
(the web calculator's convention), not per year.

## Query parameters

- `principal` number, required — Starting balance in USD.
- `rate` number, required — Interest rate in % per compounding period.
- `duration` integer, required — Length of the projection (years are capped at 50).
- `duration_unit` string, nullable — `years` (default) or `months`.
- `compound_frequency` string, nullable — `daily`, `weekly`, `monthly` (default), `quarterly` or `annually`.
- `contribution` number, nullable — Recurring deposit in USD (default 0).
- `contribution_frequency` string, nullable — `daily`, `weekly`, `monthly` (default), `quarterly` or `annually`.

## Response `200`

- object
  - `data` object
    - `final_balance` number
    - `total_contributions` integer
    - `total_interest` number
    - `roi` number
  - `meta` object
    - `note` string

---

[API](https://skmtc.net/bitculator/apis/bitculator-data-api.md) · [All operations](https://skmtc.net/bitculator/apis/bitculator-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitculator/bitculator-data-api/revisions/ed1378af68b6/schema)