calc
financas

Rendimento até Meta — quando cada meta é atingida

Para múltiplas metas (carro, viagem, casa) em paralelo, calcule em quantos meses o saldo (capital + aportes + juros) atinge cada alvo.

post/api/v1/calc/rendimento-ate-meta

Request

  • Base URL: https://api.calculas.com.br
  • URL: https://api.calculas.com.br/api/v1/calc/rendimento-ate-meta
  • Auth: HTTP bearer

Request body

capitalInicialCentsinteger

Capital já disponível em centavos. Ex: R$ 10.000 → 1000000. Padrão: 0

aporteMensalCentsinteger

Aporte mensal em centavos. Ex: R$ 500 → 50000. Padrão: R$ 500

taxaMensalPercentnumber

Taxa de rendimento mensal esperada em % (0 a 10). Ex: 0.7 = 0,7% ao mês (≈ Tesouro Selic líquido 2026). Padrão: 0,7%

prazoMaximoMesesinteger

Prazo máximo da simulação em meses (1 a 1200). Se a meta não for atingida nesse prazo, mesesParaAtingir = null. Padrão: 600 (50 anos).

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.