Calculadora de interés del préstamo

Un tipo negativo o un plazo negativo se rechazan con invalid_input en lugar de un coste negativo absurdo.

Contrato de entrada, fórmula de la cuota mensual y campos de respuesta

Un plazo negativo se rechaza igual. Los campos de estilo moneda usan redondeo half-up a dos decimales. Envíe mediante POST un cuerpo JSON con tres números finitos obligatorios. principal es el importe prestado, mayor que cero, con alias amount y loan_amount para que las hojas conserven nombres de columna conocidos. annual_rate es el porcentaje anual nominal —seis significa seis por ciento al año, no un decimal 0.06— y los alias rate, interest_rate y apr apuntan al mismo campo. Si annual_rate es negativo, la tarea falla con invalid_input nombrando el campo; ese es un error contratado y no se factura. term_years es el plazo en años, mayor que cero y como máximo cincuenta, con alias term y years. El motor forma payment_count como term_years por doce y exige que ese producto sea un número entero de cuotas mensuales, de modo que un pagaré a cinco años son sesenta pagos y uno a medio año son seis, mientras que un plazo que no cae en un mes entero se rechaza con un mensaje claro. El tipo periódico r es annual_rate entre cien dividido por doce. Cuando r es cero, cada cuota es principal dividido por payment_count y el interés total es cero. Cuando r es positivo, payment es principal por r por (uno más r) elevado a n, dividido por (uno más r) elevado a n menos uno, con n igual a payment_count. total_paid es payment por n; total_interest es total_paid menos principal. Las salidas también repiten principal, annual_rate, term_years, monthly_rate, payment_count, monthly_payment y una cadena breve formula. Campos ausentes, números no finitos, principal no positivo y un plazo que no sea un número entero de meses fallan con invalid_input y no se facturan.

Dónde aporta valor una API de interés del préstamo

Las páginas de finanzas personales que posicionan por interés del préstamo necesitan una cifra en vivo del coste vitalicio junto a la cuota para que el visitante vea por qué un plazo más largo puede parecer más barato mes a mes y aun así costar más. Asesores y coaches recorren tipo o plazo entre ofertas concurrentes y las ordenan por interés total en lugar de solo por la mensualidad. Esta página no es una identidad de interés simple, no es una herramienta de crecimiento compuesto del ahorro y no es una página EMI que lidera con la cuota mensual de una vivienda o un automóvil: esas consultas ya tienen contrato propio. La herramienta no emite un calendario período a período, impuestos, seguros, puntos ni una trayectoria de tipo variable: solo el interés vitalicio mensual a tipo fijo y los totales relacionados a partir de la cuota en forma cerrada. Mercados y originadores rellenan calculadoras desde formularios de cotización y necesitan un endpoint parse determinista que coincida con amortizaciones de hoja de cálculo sin levantar un núcleo bancario. Las aulas que enseñan amortización pueden contrastar total_interest con casos de libro y goldens redondeados estables. Como la implementación es parse pura de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente, y la validación fallida no consume saldo. Recorra term_years o annual_rate en un bucle desde su propio código para construir tablas de comparación; fije monthly_payment y total_interest en las pruebas; y mantenga las solicitudes pequeñas.