Calculadora de yield corrente

O motor é aritmética determinística pura, então gabaritos de exercício, planilhas de triagem e clientes de API sempre concordam nas mesmas entradas.

O que a rentabilidade corrente mede e como é calculada

A identidade padrão usada aqui é current_yield_percent igual a annual_coupon dividido por market_price, vezes cem. O mesmo quociente sem o passo de multiplicar por cem é current_yield_decimal, então uma rentabilidade corrente de seis vírgula três dois por cento também é cerca de zero ponto zero seis três dois do preço de compra a cada ano. Quando o cupom anual é estritamente positivo, a resposta também inclui inverse_yield, que é market_price dividido por annual_coupon: os anos daquele cupom necessários para recuperar o preço de mercado se o cupom nunca mudasse, o recíproco da rentabilidade decimal. Um cupom zero é rentabilidade corrente nula e inverse_yield é omitido em vez de voltar como null, porque chaves opcionais de saída são descartadas quando não se aplicam. Informe um face_value opcional (valor de face) e o motor também reporta coupon_rate_percent, o ágio ou o desconto em dólares frente ao par, quote_vs_par como premium, par ou discount, e yield_versus_coupon para você ver a relação de manual: uma cotação com desconto eleva a rentabilidade corrente acima da taxa de cupom; uma cotação com ágio a empurra para baixo.

Entradas, validação, arredondamento e o que a resposta contém

O preço de mercado deve ser estritamente maior que zero: preço nulo ou negativo é indefinido para o yield e é rejeitado do mesmo modo para que a automação nunca armazene Infinity. A rentabilidade decimal é arredondada para min(precision mais quatro, quinze) para que um yield pequeno, como noventa e quatro pontos-base, preserve dígitos extras depois do ponto. Respostas bem-sucedidas reiteram as duas entradas, o yield corrente em porcentagem, o yield decimal, a string da fórmula e a precisão usada. Tanto annual_coupon quanto market_price são números finitos obrigatórios nas mesmas unidades monetárias. O cupom anual pode ser zero para modelar um título cupom zero, o que produz rentabilidade corrente de zero por cento; um cupom negativo devolve um erro tipado invalid_input que nomeia o campo, porque um yield em caixa não se calcula a partir de um cupom negativo neste contrato. Os aliases opcionais coupon, coupon_payment, annual_coupon_income e c mapeiam para annual_coupon; price, current_price, bond_price e dirty_price mapeiam para market_price para que planilhas e clientes de formulário reutilizem colunas familiares. O face_value opcional (aliases par, par_value, face, nominal, face_amount) deve ser estritamente positivo quando enviado; serve só para calcular a taxa de cupom frente ao par e para classificar a cotação. Um campo opcional precision (aliases decimals, dp) controla as casas decimais de valor, porcentagem e inverse_yield, com padrão quatro e teto quinze para JSON estável. Validação falha nunca é cobrada; apenas tarefas de API bem-sucedidas consomem saldo pré-pago na tarifa base publicada de US$ 0,002. Não envie códigos CUSIP nem símbolos de ticker ao vivo: este motor não consulta cotações, juros acumulados nem calendários de cupom, e um identificador não numérico falha como invalid_input.

Onde uma calculadora de rentabilidade corrente de título justifica o seu lugar

Se precisar de uma comparação ajustada por imposto entre um cupom municipal e um yield tributável, use a ferramenta separada de yield tributável equivalente; se precisar do yield em caixa de uma ação, use a de rentabilidade por dividendo. Esta página responde apenas cupom anual sobre o preço de mercado atual, com saída estável e reproduzível na qual você pode confiar nos testes. Não substitui o yield até o vencimento quando o que importa é o arrasto ao par ao longo da vida residual do título. Investidores de renda e triadores de renda fixa usam uma calculadora de rentabilidade corrente para comparar títulos com cupom após um movimento de preço sem esperar um terminal atualizar uma coluna de yield corrente: se o cupom anual não muda e o preço de mercado cai, o yield corrente sobe e o inverse_yield de anos para recuperar o desembolso encurta. Assessores e docentes mostram aos clientes por que um yield corrente alto de manchete pode ser artefato de queda de preço e não um aumento do cupom, deixando annual_coupon fixo e mudando só market_price, e acrescentando face_value para mostrar que uma cotação com desconto fica acima da taxa de cupom. Quem usa planilha fixa o resultado sessenta sobre novecentos e cinquenta igual a 6.3158 por cento em integração contínua ao refatorar o código de tela, garantindo que arredondamento e aliases continuem a funcionar. Como isto é parse de nível A puro, cada chamada bem-sucedida custa a tarifa base publicada US$ 0,002, sem tokens de modelo e sem rede de saída; entradas inválidas não são cobradas e nada é armazenado após a resposta. Combine a página interativa gratuita para uma única cotação com o endpoint pago para triagens em lote.