calc
financas

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

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.

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

Request body

aporteInicialCentsinteger

Valor investido inicialmente em centavos. Ex: R$ 10.000 → 1000000. Padrão: R$ 10.000

aporteMensalCentsinteger

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"

prazoAnosinteger

Prazo total da simulação em anos (1 a 50). Ex: 10 = 10 anos. Padrão: 10

aporteAnualExtrainteger

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

crescimentoAporteMensalPercentnumber

% 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).

currentDatestring date-time

ISO-8601 com offset. Default: tempo do servidor. Use pra reprodutibilidade / cache semantico.

Response

OK

oktrue required
dataobject required

Resultado dependente da calc — ver schema individual

metaobject

Changes

No recorded changes to this operation across all 1 revision of this API.