Calculadora de tasa de cupón

Un valor nominal cero se rechaza con invalid_input porque no puede ser el denominador.

Qué significa la tasa de cupón y cómo el cupón anual sobre el nominal se vuelve un porcentaje

Este endpoint no obtiene cotizaciones en vivo, calendarios de devengo ni spreads de crédito. La frecuencia ya va plegada en el cupón anual que envía: si un bono paga veinticinco dos veces al año, pase cincuenta como annual_coupon, no el efectivo por periodo. El coupon_rate devuelto es el porcentaje que se cotiza en las fichas; coupon_rate_decimal es la misma razón como fracción, de modo que un cupón del cinco por ciento es cinco y cero punto cero cinco respectivamente.

Contrato de entrada, forma de la respuesta y comportamiento ante errores

El valor nominal es el campo que el contrato de producto señala: un nominal cero nunca se sustituye en silencio por cien ni por mil, y un nominal ausente no se trata como cero. La validación fallida no consume saldo, lo que mantiene baratos los scripts exploratorios cuando quien desarrolla envía a propósito un nominal cero para confirmar la ruta de error. Envíe por POST un cuerpo JSON con dos números finitos obligatorios. annual_coupon (alias annual_coupon_payment, coupon_payment, coupon y annual_payment) es el efectivo total de cupón que el bono paga en un año, en unidades monetarias. Debe ser finito y mayor o igual que cero para que un verdadero cupón cero esté permitido. face_value (alias face, par y par_value) es el importe de reembolso o a la par en la misma moneda y debe ser un número finito estrictamente mayor que cero. decimals es opcional, un entero de cero a doce (por defecto seis) que controla el redondeo half-up del porcentaje y de la tasa decimal. Si acierta, el cuerpo ecoa annual_coupon y face_value, luego coupon_rate como porcentaje, coupon_rate_decimal como fracción equivalente y una cadena formula que reescribe coupon_rate igual a cupón anual sobre nominal por cien. Ejemplo: cincuenta de cupones anuales sobre un nominal de mil devuelve coupon_rate cinco y coupon_rate_decimal cero punto cero cinco. Campos ausentes, valores no finitos, un cupón anual negativo o un valor nominal cero o negativo fallan con invalid_input nombrando el campo y no se facturan. Prefiera números JSON simples a cadenas con símbolos de moneda o signos de porcentaje; las cadenas numéricas se aceptan solo si coinciden con un patrón estricto de número finito, sin comas ni etiquetas. El precio es un $0.002 fijo por llamada exitosa con unit item.

Dónde una calculadora de tasa de cupón aporta valor

Educadores y plataformas LMS necesitan un oráculo para la pregunta de definición que pide calcular la tasa de cupón a partir del cupón anual y el nominal, incluido el caso de cupón cero, sin un terminal de datos de mercado. Los equipos de contenido pueden contrastar la tasa de cupón con el rendimiento corriente y la TIR en un bono con descuento para que el lector vea por qué tres porcentajes distintos pueden describir el mismo instrumento. Use esta capacidad cuando ya tenga dólares de cupón anual y par; si tiene un precio de mercado y años restantes y quiere la tasa de descuento de tenencia hasta el reembolso, use una calculadora de rentabilidad al vencimiento en lugar de esta definición de cupón de la escritura. Los archivos de back-office suelen guardar el efectivo de cupón anual y el nominal en columnas distintas; un endpoint determinista recupera el porcentaje sin una celda de hoja que alguien podría reescribir más tarde como rendimiento corriente al dividir por el precio de mercado. Los integradores conectan el endpoint a cuadernos, herramientas de flujo o workers en el borde para fijar goldens cuando un extracto de cartera cambia el efectivo de cupón o el nominal almacenado. Como la implementación es trabajo analítico parse de nivel A puro, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente. Mantenga face_value estrictamente positivo, fije los campos coupon_rate redondeados en las pruebas y obtendrá porcentajes de cupón reproducibles para widgets, aulas y producción sin montar su propia biblioteca de renta fija.