---
title: "Quanto Preciso para me Aposentar — patrimônio-alvo e aporte mensal"
method: POST
path: "/api/v1/calc/quanto-para-aposentar"
tags: ["calc", "financas"]
---

# Quanto Preciso para me Aposentar — patrimônio-alvo e aporte mensal

`POST /api/v1/calc/quanto-para-aposentar`

## Request

- Base URL: `https://api.calculas.com.br`
- URL: `https://api.calculas.com.br/api/v1/calc/quanto-para-aposentar`
- Auth: HTTP bearer

Calcule quanto patrimônio você precisa acumular e quanto aportar por mês para sustentar sua renda desejada na aposentadoria. Regra 4% (Trinity Study) + projeção em reais de hoje.

## Request body

- object
  - `idadeAtual` integer: Sua idade atual em anos inteiros (18 a 80). Padrão: 35
  - `idadeMetaAposentadoria` integer: Idade em que você pretende se aposentar (35 a 90). Deve ser maior que a idade atual. Padrão: 60
  - `gastoMensalDesejadoCents` integer: Gasto mensal desejado na aposentadoria em centavos (em reais de hoje, descontando inflação). Usado quando gastosCategorizadosCents é vazio. Ex: R$ 8.000 → 800000. Padrão: R$ 8.000
  - `gastosCategorizadosCents` object[]: Gastos meta na aposentadoria por categoria (moradia, alimentacao, saude, lazer, transporte, educacao, vestuario, seguros, servicos_profissionais, outro). Quando NÃO-vazio, a soma SUBSTITUI gastoMensalDesejadoCents para calcular o patrimônio-alvo. Cada item: { categoria, valorCents, descricao? }. Padrão []. Pensa por categoria — alguém quer R$ 3k em moradia + R$ 2k em saude + R$ 2k lazer + R$ 1k transporte; total ≈ R$ 8k não cai do céu, vem de quebra realista.
    - `categoria` 'moradia' | 'alimentacao' | 'transporte' | 'saude' | 'educacao' | 'lazer' | 'vestuario' | 'seguros' | 'servicos_profissionais' | 'outro', required
    - `valorCents` integer, required: Valor em centavos. Ex: R$ 200 → 20000.
    - `descricao` string: Descrição livre do item (opcional, especialmente útil quando categoria = "outro"). Máx. 60 caracteres.
  - `patrimonioAtualCents` integer: Patrimônio financeiro que você já possui investido em centavos. Ex: R$ 50.000 → 5000000. Padrão: 0
  - `aporteMensalAtualCents` integer: Valor que você aporta por mês em investimentos atualmente em centavos. Ex: R$ 1.000 → 100000. Padrão: 0
  - `taxaRealAnualPercent` number: Taxa de rendimento real anual esperada dos investimentos, acima da inflação, em % (0 a 15). Ex: 4 = 4% a.a. real (≈ Tesouro IPCA+ líquido). Padrão: 4%
  - `taxaSeguraSaquePercent` number: Taxa de retirada segura anual do patrimônio na aposentadoria em % (2 a 8). A regra dos 4% (Trinity Study) é o valor clássico recomendado. Ex: 4 = retirar 4% por ano. Padrão: 4%
  - `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)