---
title: "Calculadora de Juros Compostos"
method: POST
path: "/api/v1/calc/juros-compostos"
tags: ["calc", "financas"]
---

# Calculadora de Juros Compostos

`POST /api/v1/calc/juros-compostos`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/juros-compostos`
- Auth: HTTP bearer

Simule o poder dos juros compostos com aportes mensais. Veja quanto seu dinheiro pode render no longo prazo.

## Request body

- object
  - `capitalInicialCents` integer, required: Valor inicial já investido em centavos. Ex: R$ 10.000 → 1000000. Pode ser zero
  - `aporteMensalCents` integer, required: Valor aportado todo mês em centavos. Ex: R$ 500 → 50000. Pode ser zero
  - `taxaMensalPercent` number, required: Taxa de juros mensal em % (0 a 50). Ex: 1 = 1% ao mês (≈12,68% ao ano). Para Tesouro Selic em 2026, use ≈ 0,9%
  - `prazoMeses` integer, required: Prazo total da simulação em meses (1 a 1200). Ex: 120 = 10 anos. Máximo 1200 meses (100 anos)
  - `aporteAnualExtra` integer: Aporte extra agregado uma vez por ano (some 13º + PLR + bônus + RVA) em centavos. Aplicado no fechamento de cada 12 meses. Ex: R$ 8.000 → 800000. Padrão: 0
  - `crescimentoAporteMensalPercent` number: Crescimento percentual anual do aporte mensal (% ao ano). Aplicado no aniversário (a cada 12 meses) — emparelha com inflação salarial. Ex: 5 = aumenta o aporte em 5% ao ano. Aceita valores negativos. Padrão: 0 (aporte constante)
  - `currentDate` string, date-time: ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

## Response `200`

OK

- object
  - `ok` true, required
  - `data` object, required: Resultado dependente da calc — ver schema individual
  - `meta` object

## Other responses

- `422`: Input invalido (Zod parse falhou)
- `500`: Engine error

---

[API](https://skmtc.dev/calculas/apis/contai-api.md) · [All operations](https://skmtc.dev/calculas/apis/contai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/calculas/apis/contai-api/revisions/26a00749292b?raw)