Calculadora de taxa de cupom

Um valor de face zero é rejeitado com invalid_input porque não pode ser o denominador.

O que a taxa de cupom significa e como o cupom anual sobre a face vira porcento

A taxa de cupom é o juro anual contratual do título como porcento do valor de face: pagamentos anuais de cupom divididos pelo par, vezes cem. Este endpoint não busca cotações ao vivo, calendários de day-count nem spreads de crédito. A frequência já está embutida no cupom anual que você envia: se um título paga vinte e cinco duas vezes por ano, passe cinquenta como annual_coupon, não o caixa por período. O coupon_rate devolvido é o porcento cotado nas lâminas; coupon_rate_decimal é a mesma razão como fração, de modo que um cupom de cinco por cento é cinco e zero ponto zero cinco, respectivamente.

Contrato de entrada, formato da resposta e comportamento de erro

O valor de face é o campo que o contrato de produto destaca: uma face zero nunca é trocada em silêncio por cem nem por mil, e uma face ausente não é tratada como zero. Validação que falha não consome saldo, o que mantém baratos os scripts exploratórios quando quem desenvolve envia de propósito uma face zero para confirmar o caminho de erro. Envie por POST um corpo JSON com dois números finitos obrigatórios. annual_coupon (aliases annual_coupon_payment, coupon_payment, coupon e annual_payment) é o caixa total de cupom que o título paga em um ano, em unidades de moeda. Deve ser finito e maior ou igual a zero para que um verdadeiro zero-cupom seja permitido. face_value (aliases face, par e par_value) é o montante de resgate ou ao par na mesma moeda e deve ser um número finito estritamente maior que zero. decimals é opcional, um inteiro de zero a doze (padrão seis) que controla o arredondamento half-up do porcento e da taxa decimal. Em caso de sucesso o corpo ecoa annual_coupon e face_value, depois coupon_rate como porcento, coupon_rate_decimal como fração equivalente e uma string formula que reescreve coupon_rate igual a cupom anual sobre face vezes cem. Exemplo: cinquenta de cupons anuais sobre face mil devolve coupon_rate cinco e coupon_rate_decimal zero ponto zero cinco. Campos ausentes, valores não finitos, cupom anual negativo ou valor de face zero ou negativo falham com invalid_input nomeando o campo e não são cobrados. Prefira números JSON simples a strings com símbolos de moeda ou sinais de porcento; strings numéricas só são aceitas quando batem com um padrão estrito de número finito, sem vírgulas nem rótulos. O preço é um US$ 0,002 fixo por chamada bem-sucedida com unit item.

Onde uma calculadora de taxa de cupom agrega valor

Educadores e plataformas LMS precisam de um oráculo para a pergunta de definição que pede calcular a taxa de cupom a partir do cupom anual e da face, inclusive o caso zero-cupom, sem um terminal de dados de mercado. Equipes de conteúdo podem contrastar a taxa de cupom com o current yield e o YTM num título com desconto para o leitor ver por que três porcentagens diferentes podem descrever o mesmo instrumento. Use esta capacidade quando você já tem dólares de cupom anual e par; se tem preço de mercado e anos restantes e quer a taxa de desconto de carregar até o resgate, use uma calculadora de yield até o vencimento em vez desta definição de cupom da escritura. Arquivos de back-office costumam guardar o caixa de cupom anual e a face em colunas separadas; um endpoint determinístico recupera o porcento sem uma célula de planilha que alguém depois reescreveria como current yield ao dividir pelo preço de mercado. Integradores ligam o endpoint a notebooks, ferramentas de fluxo ou edge workers para fixar goldens quando um extrato de carteira muda o caixa de cupom ou a face armazenados. Mantenha face_value estritamente positivo, fixe os campos coupon_rate arredondados nos testes e obtenha porcentos de cupom reproduzíveis para widgets, salas de aula e produção sem montar sua própria biblioteca de renda fixa.