Calculadora de rentabilidade de título
Um título com valor de face 1.000, cupom de 5% e 10 anos pela frente, comprado a 1.000, rende exatamente 5% até o vencimento: no par, o yield é igual ao cupom. Informe seu preço para ver como um deságio ou um ágio o altera. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Valor de face
- 1.000
- Taxa de cupom
- 5
- Preço atual
- 1.000
- Anos até o vencimento
- 10
- Pagamento do cupom
- 50
- Rendimento (%)
- 5
- Rendimento (decimal)
- 0,05
- Rendimento corrente (%)
- 5
A rentabilidade até o vencimento de um título é a única taxa anualizada que iguala o valor presente dos cupons restantes e do pagamento de face ao preço que você pagaria hoje. Estudantes, assessores e equipes de produto precisam dessa taxa a partir de quatro números — valor de face, taxa de cupom, preço atual e anos até o vencimento — sem abrir uma planilha nem uma biblioteca completa de renda fixa. Esta calculadora de rentabilidade de título resolve a identidade clássica de cupom anual para y, devolve o yield anualizado como percentual e como decimal, e também informa o valor do cupom anual e o yield corrente (cupom sobre preço).
O que significa o yield até o vencimento de um título
O yield até o vencimento é a única taxa anual constante que faz o valor presente dos fluxos restantes de um título com cupom coincidir com o preço de mercado que você pagaria hoje. Esses fluxos são o cupom anual — o valor de face vezes a taxa de cupom em percentual, dividido por cem — pago uma vez por ano durante a vida residual, mais o valor de face (par) reembolsado no vencimento.
Se você manter o título até o vencimento, reinvestir os cupons nessa mesma taxa e receber a face no prazo, o retorno anualizado realizado iguala o yield que esta calculadora informa. Quando o título negocia ao par, o preço atual iguala a face e o yield iguala a taxa de cupom. Quando negocia com desconto, o preço fica abaixo da face e o yield supera o cupom, porque o detentor também ganha a convergência ao par.
Quando negocia com prêmio, o preço supera a face e o yield fica abaixo do cupom, porque parte de cada cupom é compensada pela baixa rumo ao par. Um título zero-cupom é o caso especial de taxa de cupom nula: o único fluxo é a face no vencimento, de modo que o yield é o desconto anualizado do preço até a face.
O modelo usa capitalização anual e uma anuidade de cupom anual; não aplica convenções de contagem de dias, cotação semestral municipal, preço sujo versus limpo nem decomposição de spreads de crédito. Responde à pergunta central que estudantes, assessores e páginas de produto buscam como yield de título ou rentabilidade até o vencimento: dados face, cupom, preço e anos, qual é o yield anualizado?
Contrato de entrada, fórmula e campos de resposta
Quando o cupom é zero, a identidade colapsa para a forma fechada y igual a (face sobre preço) elevado a um sobre n, menos um. Quando o preço iguala a face, y iguala a taxa de cupom como decimal. O solver usa iteração de Newton a partir do palpite padrão de cupom médio mais amortização e, se preciso, uma bisseção limitada em y maior que menos um, de modo que o resultado é determinístico e independente de relógios ou aleatoriedade.
Exemplo: face mil, cupom cinco, preço mil, dez anos produz cinco por cento até o vencimento e um yield corrente de cinco por cento — a identidade ao par.
Onde uma calculadora de rentabilidade de título agrega valor
Ferramentas de patrimônio, tesouraria e corretagem costumam cotar um yield anualizado simples ao lado de um preço de tela quando o calendário completo ainda não foi carregado, ou quando uma landing de produto só tem face, cupom, preço e anos restantes. Geradores de entrevistas e lições de casa exigem um oráculo determinístico que marque um yield errado e rejeite um preço atual não positivo em vez de devolver NaN ou um objeto vazio silencioso.
Esta ferramenta não produz duração de Macaulay, duração modificada, convexidade, yield equivalente semestral nem desconto multi-curva — apenas o yield com capitalização anual que iguala o valor presente do título com cupom ao preço que você informou. Use-a quando a pergunta for o yield anualizado simples do título e acrescente análises mais ricas no seu próprio serviço quando precisar.
Casos de uso
Conferências de sala e exames
Confira respostas de yield até o vencimento dos manuais para títulos ao par, com desconto, com prêmio e zero-cupom a partir de face, cupom, preço e anos.
Widgets de produto e carteira
Mostre aos investidores o yield anualizado até o vencimento ao lado de um preço de tela cotado em páginas de calculadora e fluxos de onboarding.
Perguntas frequentes
Como se calcula o yield até o vencimento de um título?
Um cupom zero usa y = (F/P)^(1/n) − 1. Um título ao par (preço igual à face) rende a taxa de cupom.
O que acontece se o preço atual for zero ou negativo?
O yield até o vencimento não está definido para um preço de mercado não positivo, e a validação falha não é cobrada.
Por que o yield fica acima do cupom quando o título é negociado abaixo do valor de face?
Porque, além dos cupons, você ganha a diferença entre o preço mais baixo e o valor de face pago no vencimento. Acima do valor de face acontece o contrário: essa perda consome parte de cada cupom e o yield fica abaixo.
Qual é a diferença entre yield até o vencimento e rendimento corrente?
O rendimento corrente é só o cupom anual dividido pelo preço de hoje. Ele ignora o ganho ou a perda até o preço chegar ao valor de face no vencimento, que o yield até o vencimento inclui. Você recebe os dois para comparar.
Dá para calcular o yield de um título zero-cupom?
Sim. Informe um cupom igual a zero. O único pagamento passa a ser o valor de face no vencimento, então o yield é a taxa anual que transforma o preço de hoje nesse valor ao longo dos anos restantes.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/fin/bond-yield \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"face_value":1000,"coupon_rate":5,"current_price":950,"years_to_maturity":10}'const res = await fetch("https://api.kit.forhosting.com/fin/bond-yield", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"face_value": 1000,
"coupon_rate": 5,
"current_price": 950,
"years_to_maturity": 10
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/fin/bond-yield",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"face_value": 1000,
"coupon_rate": 5,
"current_price": 950,
"years_to_maturity": 10
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/bond-yield", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"face_value":1000,"coupon_rate":5,"current_price":950,"years_to_maturity":10}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"face_value":1000,"coupon_rate":5,"current_price":950,"years_to_maturity":10}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/bond-yield", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"face_value": 1000,
"coupon_rate": 5,
"current_price": 950,
"years_to_maturity": 10
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "fin.bond_yield",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Um preço atual que não seja positivo é rejeitado com invalid_input e não é cobrado.
O que significa o yield até o vencimento de um título
O yield corrente é uma razão diferente e mais simples — o cupom anual dividido pelo preço atual — e não contabiliza o ganho ou a perda até o par; este endpoint devolve os dois para que você veja a diferença.
Contrato de entrada, fórmula e campos de resposta
Envie um corpo JSON com quatro números finitos obrigatórios. face_value é o valor par reembolsado no vencimento e deve ser maior que zero (aliases: face, par, par_value). coupon_rate é o cupom anual como percentual — cinco significa cinco por cento ao ano, não uma fração decimal — e deve ser maior ou igual a zero (aliases: coupon, coupon_percent). current_price é o preço de mercado presente nas mesmas unidades de moeda que a face e deve ser estritamente positivo; preço zero ou negativo é rejeitado com invalid_input nomeando current_price e não é cobrado (aliases: price, market_price). years_to_maturity é a vida residual em anos, maior que zero e no máximo duzentos; anos fracionários são permitidos, de modo que um resto de seis meses pode ser informado como 0.5 (aliases: years, maturity, n). O motor forma o cupom anual C como face_value vezes coupon_rate sobre cem e resolve a identidade preço igual a C vezes um menos um mais y elevado a menos n, tudo sobre y, mais a face sobre um mais y elevado a n, para o yield anualizado desconhecido y. A resposta ecoa as quatro entradas, coupon_payment, yield_percent (y vezes cem, half-up a seis decimais), yield_decimal (y half-up a oito decimais), current_yield_percent (cupom sobre preço vezes cem) e uma string curta de fórmula. Campos ausentes, strings vazias, valores não finitos, um preço atual não positivo, uma taxa de cupom negativa ou anos fora do intervalo aceito falham com invalid_input.
Onde uma calculadora de rentabilidade de título agrega valor
Percorra current_price ou years_to_maturity em um loop no seu próprio código para construir uma curva preço-yield com cupom fixo; fixe yield_percent nos testes; mantenha as requisições pequenas.
Casos de integração
Varreduras de cenários preço-yield
Percorra current_price ou years_to_maturity para construir uma curva de yield anual simples com cupom fixo, sem uma biblioteca completa de títulos.
Perguntas técnicas
Quais unidades devo usar para taxa de cupom, preço e vencimento?
coupon_rate é um percentual ao ano (5 significa 5%, não 0.05). current_price e face_value compartilham as mesmas unidades de moeda. years_to_maturity está em anos e pode ser fracionário (0.5 para seis meses).
O yield corrente é o mesmo que o yield até o vencimento?
Não. current_yield_percent é o cupom anual dividido pelo preço atual. yield_percent é a taxa interna de retorno que também contabiliza o ganho ou a perda do preço de hoje até a face no vencimento.
Quanto custa a calculadora de rentabilidade de título?
A ferramenta do navegador é gratuita. As requisições à API usam o saldo pré-pago de KIT a US$ 0,002 por chamada bem-sucedida; a entrada inválida não é cobrada.