ForHosting KIT · Finanças e dinheiro

Calculadora de pagamento de cupom

Um título de 1.000 com cupom de 5% pago duas vezes por ano paga 25 em cada data, 50 no ano. Digite o valor de face, a taxa de cupom anual e os pagamentos por ano para ver o dinheiro que cada data de cupom traz. Grátis no seu navegador.

Grátis
Funciona no seu navegador
Sem cadastro
Seus dados não saem do seu aparelho

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Exemplo resolvido

Se você digitar

Valor de face: 1.000
Taxa de cupom: 5
Pagamentos por ano: 2

Você obtém

Taxa de cupom (decimal): 0,05
Cupom anual: 50
Pagamento do cupom: 25

O pagamento de cupom é o caixa que um título com cupom entrega ao detentor em cada data de juros prevista: não é o yield, nem o preço de mercado, nem o valor presente de um instrumento sem cupom. Estudantes, assessores e equipes de produto precisam desse valor a partir de três números — valor de face (par), taxa de cupom anual e quantas vezes no ano o emissor paga — sem abrir uma planilha nem uma biblioteca completa de renda fixa. Esta calculadora de pagamento de cupom aplica a identidade dos manuais: o cupom iguala a face vezes a taxa anual dividida pelos pagamentos no ano, devolve o pagamento periódico e o cupom anual total, e falha com clareza quando os pagamentos no ano não são um inteiro positivo.

O que é e o que não é um pagamento de cupom

Um pagamento de cupom é o caixa contratual que um título com cupom envia ao detentor em cada data de juros prevista. Não é o preço de mercado do título, nem o yield até o vencimento, nem o valor presente de um recorte zero-cupom: essas respostas exigem uma taxa de desconto e uma vida residual. O próprio cupom figura na escritura como valor de face (par) vezes a taxa de cupom anual, depois repartido pelo número de pagamentos que o emissor faz a cada ano.

Um título de mil ao par com cupom anual de cinco por cento que paga duas vezes no ano envia vinte e cinco em cada data semestral; o mesmo título que paga uma vez no ano envia cinquenta na única data de cupom; um calendário trimestral divide o cupom anual por quatro, e um mensal divide por doze. Investidores, estudantes e equipes de produto buscam uma calculadora de pagamento de cupom quando precisam dessa cifra a partir da face, da taxa e da frequência, sem uma planilha.

Esta ferramenta aplica essa identidade, devolve o cupom periódico e o cupom anual total, e rejeita um valor de pagamentos no ano que não seja um inteiro positivo, para que uma frequência fracionária ou nula nunca produza em silêncio um pagamento sem sentido. Convenções de contagem de dias, preço sujo versus limpo e juros apropriados entre datas de cupom ficam fora do escopo: essas peças partem do valor de cupom que esta calculadora informa, não o substituem.

Uma taxa de cupom nula é permitida e produz pagamento nulo, que é o aspecto de um verdadeiro título zero-cupom quando você pergunta só pelo caixa do cupom, não por um preço descontado.

Casos de uso

Conferências de sala e exames

Confira pagamentos de cupom dos manuais para títulos anuais, semestrais, trimestrais e mensais a partir da face, da taxa anual e dos pagamentos no ano.

Widgets de produto e extrato

Mostre aos investidores o valor do próximo cupom ao lado da face e da taxa cotadas em páginas de alta ou de calculadora, sem uma biblioteca completa de títulos.

Perguntas frequentes

O que acontece se os pagamentos no ano não forem um número inteiro?

Frequências nulas, negativas e fracionárias não são cobradas.

Em que isso difere do yield de um título ou do preço de um zero-cupom?

Esta capacidade responde só quanto caixa cada cupom paga. O yield até o vencimento exige um preço de mercado e uma vida residual; o preço de um zero-cupom desconta um único fluxo de face. Nenhum dos dois é calculado aqui.

Como calculo o cupom de um título trimestral ou mensal?

Multiplique o valor de face pela taxa de cupom anual para obter o cupom do ano e divida pelo número de pagamentos: por 4 se for trimestral, por 12 se for mensal. A calculadora faz as duas etapas de uma vez.

Digito a taxa de cupom como 5 ou 0,05?

Digite 5 para um cupom de 5%. A taxa entra como percentual, do jeito que aparece no título, e a calculadora a converte em decimal sozinha.

O resultado inclui juros acumulados?

Não. Convenções de contagem de dias, juros acumulados entre datas de cupom e preço limpo ou sujo ficam de fora. Esses cálculos partem do valor de cupom que esta ferramenta devolve, sem substituí-lo.

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

POSThttps://api.kit.forhosting.com/fin/coupon-payment

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/coupon-payment \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"face_value":1000,"coupon_rate":5,"payments_per_year":2}'

const res = await fetch("https://api.kit.forhosting.com/fin/coupon-payment", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "face_value": 1000,
    "coupon_rate": 5,
    "payments_per_year": 2
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/fin/coupon-payment",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "face_value": 1000,
    "coupon_rate": 5,
    "payments_per_year": 2
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/fin/coupon-payment", 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,"payments_per_year":2}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"face_value":1000,"coupon_rate":5,"payments_per_year":2}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/fin/coupon-payment", 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,
  "payments_per_year": 2
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "fin.coupon_payment",
  "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

por chamadaUS$ 0,002

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

Contrato de entrada, fórmula e campos de resposta

Campos monetários usam arredondamento half-up a duas casas para que os goldens permaneçam estáveis entre runtimes. Exemplo: face mil, cupom cinco, dois pagamentos no ano produz um cupom periódico de vinte e cinco e um cupom anual de cinquenta — a identidade semestral dos manuais. Envie um corpo JSON com três campos obrigatórios. face_value é o valor par usado para dimensionar o cupom e deve ser um número finito 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, annual_coupon_rate). payments_per_year indica quantas datas de cupom caem em um ano e deve ser um inteiro positivo de um a trezentos e sessenta e cinco; os valores típicos são um (anual), dois (semestral), quatro (trimestral) e doze (mensal). Os aliases frequency, n, periods_per_year e m apontam para o mesmo campo. Uma frequência nula, negativa ou não inteira é rejeitada com invalid_input nomeando payments_per_year e não é cobrada — esse é o contrato rígido desta capacidade. O motor forma a taxa decimal r como coupon_rate sobre cem, o cupom anual como face_value vezes r, e o coupon_payment periódico como esse cupom anual dividido por payments_per_year. A resposta ecoa as três entradas, coupon_rate_decimal (r), annual_coupon, coupon_payment e uma string curta de fórmula. Campos ausentes, strings vazias, valores não finitos, uma face não positiva ou uma taxa de cupom negativa também falham com invalid_input.

Onde uma calculadora de pagamento de cupom agrega valor

Ferramentas de patrimônio, tesouraria e corretagem costumam precisar do valor em caixa do próximo cupom antes de carregar um calendário completo ou um motor de yield, ou quando uma landing de produto só tem face, taxa de cupom e frequência. Esta ferramenta não produz yield até o vencimento, preço presente de um zero-cupom, duração de Macaulay nem juros apropriados — apenas o caixa contratual do cupom. Use-a quando a pergunta for o valor periódico do cupom e acrescente análises mais ricas no seu próprio serviço quando precisar. Geradores de entrevistas e lições de casa exigem um oráculo determinístico que marque um cupom errado e rejeite um payments_per_year não inteiro em vez de devolver NaN ou um objeto vazio silencioso. Percorra payments_per_year ou coupon_rate em um loop no seu próprio código para comparar calendários com face fixa; fixe coupon_payment nos testes; mantenha as requisições pequenas.

Casos de integração

Comparação de calendários com face fixa

Percorra payments_per_year para ver como o mesmo cupom anual se reparte em duas, quatro ou doze datas antes de montar uma tabela de fluxos.

Perguntas técnicas

Como o pagamento de cupom é calculado?

A identidade é coupon_payment = face_value × (coupon_rate/100) / payments_per_year. A API também devolve annual_coupon (face vezes a taxa decimal) e coupon_rate_decimal.

O campo coupon_rate é um percentual ou um decimal?

Um percentual ao ano: 5 significa 5%, não 0.05. A resposta inclui coupon_rate_decimal para que uma planilha conserve a fração ao lado do percentual que se digita.

Quanto custa a calculadora de pagamento de cupom?

A ferramenta do navegador é gratuita. As solicitações à API usam o saldo pré-pago de KIT a US$ 0,002 por chamada bem-sucedida; entrada inválida não é cobrada.

Ver a documentação completa do KIT →

Executar grátis