Calculadora de CDB

Um principal que não seja um número positivo falha com invalid_input e não é cobrado.

Como o valor futuro de um CDB é capitalizado

Converta o percentual numa taxa decimal r igual a annual_rate dividido por cem.

Contrato de entrada, formato da resposta e comportamento de erro

Principal é o campo que o contrato de produto destaca: zero, um depósito negativo ou um substituto não numérico nunca são tratados como brinde nem como cupom zero silencioso. Envie por POST um corpo JSON com quatro campos obrigatórios. principal é o depósito de abertura como número finito maior que zero (aliases amount e deposit). annual_rate é o juro nominal anual como percentual —cinco para cinco por cento ao ano—, finito, pelo menos zero e no máximo mil (aliases rate e interest_rate). term é o travamento em anos como número finito maior que zero e no máximo cem; um CDB de seis meses é term 0.5 e um de três meses é term 0.25 (aliases years e term_years). compounding é um do conjunto fechado annual, semiannual, quarterly, monthly, weekly, daily ou continuous (aliases frequency e compounds). Cada campo numérico pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias, booleanos, valores não finitos, um principal não positivo, um annual_rate negativo, um term não positivo e qualquer valor de compounding fora do enum falham com invalid_input nomeando o campo e não são cobrados. Em caso de sucesso o corpo ecoa principal, annual_rate, term e compounding, e acrescenta compounds_per_year quando o calendário é discreto, maturity_value, interest_earned, apy_percent e uma string formula que reafirma a identidade discreta, o caso contínuo e o colapso a taxa zero. Exemplo: principal dez mil, annual_rate cinco, term dois, compounding quarterly produz n igual a quatro e um valor no vencimento igual a dez mil vezes 1.0125 elevado à oitava, arredondado a centavos, com interest_earned igual a esse vencimento menos o principal. Este endpoint não modela multas de resgate antecipado, taxas isca que mudam no meio do prazo nem limites de garantia de depósitos; calcula só os juros compostos mantidos até o vencimento.

Onde uma calculadora de vencimento de CDB agrega valor

Educadores que ensinam capitalização discreta versus contínua podem semear exemplos de aula que falhem alto quando o principal não é um número positivo, em vez de traçar uma curva sem sentido por um depósito nulo ou negativo. Validação falha não consome saldo. Mantenha o principal positivo, o prazo em anos e compounding dentro do enum, fixe os campos de dinheiro arredondados nos testes e obtenha vencimentos de CDB reproduzíveis para widgets, módulos LMS e workers na borda sem um stack próprio de originação de depósitos. Tabelas comparativas que alinham um CDB diário de seis meses a um trimestral de um ano podem chamar o mesmo módulo puro no navegador para prévias gratuitas e na API ao gravar um cenário, garantindo que o vencimento que um visitante viu coincida com o vencimento armazenado depois de salvar a cotação. Quem planeja o orçamento doméstico e já conhece o caixa que pode travar pode enviar principal, annual_rate, term e compounding para preencher um cartão com valor no vencimento, juros ganhos e APY, e decidir se esticar de doze para vinte e quatro meses vale o travamento extra. Equipes de produto que montam uma escada de CDB podem pedir vários prazos com o mesmo principal e taxa e ler interest_earned em cada degrau sem escrever a própria função de potência. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo nem rede de saída.