---
title: "Simulador de Carteira por Perfil — quanto seu dinheiro rende a longo prazo"
method: POST
path: "/api/v1/calc/simulador-carteira-xp"
tags: ["calc", "financas"]
---

# Simulador de Carteira por Perfil — quanto seu dinheiro rende a longo prazo

`POST /api/v1/calc/simulador-carteira-xp`

## Request

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

Projete o patrimônio acumulado em aporte inicial + aportes mensais por perfil de investidor (conservador, moderado, agressivo). Taxa anual real estimada com base em históricos públicos do CDI/IPCA+/Ibovespa.

## Request body

- object
  - `aporteInicialCents` integer: Valor investido inicialmente em centavos. Ex: R$ 10.000 → 1000000. Padrão: R$ 10.000
  - `aporteMensalCents` integer: Valor aportado mensalmente em centavos. Ex: R$ 1.000 → 100000. Padrão: R$ 1.000
  - `perfil` 'conservador' | 'moderado' | 'agressivo': Perfil de investidor que define a taxa real anual estimada: "conservador" (6% a.a. — Tesouro Selic, CDB), "moderado" (8% a.a. — mix renda fixa e variável), "agressivo" (10% a.a. — predominância de renda variável). Padrão: "moderado"
  - `prazoAnos` integer: Prazo total da simulação em anos (1 a 50). Ex: 10 = 10 anos. Padrão: 10
  - `aporteAnualExtra` integer: Aporte extra anual em centavos (representa 13°, bônus, PLR, restituição IR aportados de uma vez por ano). Aplicado ao final dos meses 12, 24, 36... Ex: R$ 6.000 → 600000. Padrão: 0
  - `crescimentoAporteMensalPercent` number: % de crescimento do aporte mensal a cada aniversário (12 meses), simulando aumento salarial. Pode ser negativo até -10% (redução). Ex: 5 = +5% ao ano. Padrão: 0% (aporte plano).
  - `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)