Calculadora de dividendo

Un recuento de acciones en circulación igual a cero se rechaza con invalid_input porque no puede ser el denominador.

Qué significan el dividendo por acción y la rentabilidad, y cómo el efectivo se vuelve una tasa

Este endpoint no obtiene informes ni cotizaciones en vivo. Aplica las definiciones que usted aporta para que claves de ejercicios, widgets de aterrizaje y automatización compartan un único importe y una única tasa auditables. total_dividends es el efectivo agregado que desea en el numerador: dividendos anuales, de los últimos doce meses o la tasa anual indicada, siempre que sea coherente. shares_outstanding es el denominador del importe por acción y debe ser un número finito mayor que cero; un recuento cero no puede dividir y se rechaza en lugar de inventar un dividendo. share_price debe ser un número finito mayor que cero para que la rentabilidad tenga denominador válido.

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

Las acciones en circulación son el campo que el contrato de producto señala: un recuento cero nunca se sustituye en silencio por uno, y un recuento 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 recuento cero para confirmar la ruta de error. Envíe por POST un cuerpo JSON con tres números finitos obligatorios. total_dividends (alias total_dividend, dividends, dividend_paid y cash_dividends) es el dividendo de efectivo agregado en unidades monetarias. Debe ser finito y mayor o igual que cero para que se permita una sociedad que no pagó nada. shares_outstanding (alias shares, number_of_shares, outstanding_shares y shares_issued) es el recuento de acciones usado como denominador por acción y debe ser un número finito estrictamente mayor que cero. share_price (alias price, stock_price, market_price y last_price) es la cotización en la misma moneda que el dividendo 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 importe por acción y de ambos campos de rentabilidad. Si acierta, el cuerpo ecoa total_dividends, shares_outstanding y share_price, luego dividend_per_share como el efectivo por acción, dividend_yield como porcentaje, dividend_yield_decimal como la fracción equivalente y una cadena formula que reescribe que el dividendo por acción es el total entre las acciones y que la rentabilidad es el dividendo por acción entre el precio. Ejemplo: dos mil millones de dividendos totales, quinientos millones de acciones y un precio de cincuenta devuelven dividend_per_share cuatro, dividend_yield ocho y dividend_yield_decimal 0.08. Campos ausentes, valores no finitos, un total negativo o un recuento o un precio 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 dividendo aporta valor

Educadores y plataformas LMS necesitan un oráculo para la pregunta de definición que pide calcular el dividendo por acción a partir del total y de las acciones en circulación, incluido el caso de efectivo cero, sin un terminal de datos de mercado. Los equipos de contenido pueden contrastar la rentabilidad trailing con la rentabilidad a futuro sobre el mismo recuento para que el lector vea por qué dos porcentajes pueden describir un mismo ticker cuando la tasa indicada difiere del efectivo del año anterior. Use esta capacidad cuando ya tenga el efectivo total, un recuento de acciones y un precio; si tiene dólares de cupón anual y un nominal de bono, use una calculadora de tasa de cupón en lugar de esta definición de dividendo de renta variable. Los archivos de back-office suelen guardar el total de dividendos pagados, las acciones en circulación y el último precio en columnas distintas; un endpoint determinista recupera DPS y rentabilidad sin una celda de hoja que alguien podría reescribir más tarde como payout al dividir entre el beneficio. 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 almacenado, el recuento diluido o la cotización. 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 shares_outstanding y share_price estrictamente positivos, fije los campos dividend_per_share y dividend_yield redondeados en las pruebas y obtendrá importes y rentabilidades reproducibles para widgets, aulas y producción sin montar su propia biblioteca de investigación de renta variable.