---
title: "Simulador de Aposentadoria — quanto acumular e qual renda"
method: POST
path: "/api/v1/calc/simulador-aposentadoria"
tags: ["calc", "financas"]
---

# Simulador de Aposentadoria — quanto acumular e qual renda

`POST /api/v1/calc/simulador-aposentadoria`

## Request

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

Projete seu patrimônio até a aposentadoria com aportes mensais compostos. Descubra quanto acumula e qual renda mensal esse saldo gera pela regra dos 4%.

## Request body

- object
  - `idadeAtual` integer, required: Sua idade atual em anos inteiros (18 a 75)
  - `idadeAposentadoria` integer, required: Idade em que você pretende se aposentar (19 a 85). Deve ser maior que a idade atual
  - `patrimonioAtualCents` integer: Patrimônio financeiro já acumulado em centavos. Ex: R$ 50.000 → 5000000. Padrão: 0
  - `aporteMensalCents` integer: Valor aportado mensalmente em investimentos em centavos. Ex: R$ 1.000 → 100000. Padrão: R$ 500
  - `taxaMensalPercent` number: Taxa de rendimento mensal dos investimentos em % (0,01 a 3). Ex: 0.7 = 0,7% ao mês (≈ Tesouro Selic líquido). Padrão: 0,7%
  - `taxaRetiradaMensalPercent` number: Taxa de retirada mensal do patrimônio na aposentadoria em % (0,01 a 1). 0,327% ao mês equivale à regra dos 4% ao ano (Trinity Study). Padrão: 0,327%
  - `reajusteAnualAportesPercent` number: Percentual de reajuste anual dos aportes em % (0 a 30). Ex: 5 = aumentar o aporte em 5% todo ano. Padrão: 0 (aportes constantes)
  - `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
  - `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)