Calculadora de dividendos

Uma contagem de ações em circulação igual a zero é rejeitada com invalid_input porque não pode ser o denominador.

O que significam o dividendo por ação e a rentabilidade, e como o caixa vira uma taxa

Este endpoint não busca relatórios nem cotações ao vivo. Aplica as definições que você fornece para que gabaritos, widgets de landing e automação compartilhem um único valor e uma única taxa auditáveis. total_dividends é o caixa agregado que você quer no numerador: dividendos anuais, dos últimos doze meses ou a taxa anual indicada, desde que seja coerente. shares_outstanding é o denominador do valor por ação e deve ser um número finito maior que zero; uma contagem zero não pode dividir e é rejeitada em vez de inventar um dividendo. share_price deve ser um número finito maior que zero para que a rentabilidade tenha denominador válido.

Contrato de entrada, formato da resposta e comportamento de erro

As ações em circulação são o campo que o contrato de produto destaca: uma contagem zero nunca é trocada em silêncio por um, e uma contagem ausente não é tratada como zero. Validação que falha não consome saldo, o que mantém baratos os scripts exploratórios quando quem desenvolve envia de propósito uma contagem zero para confirmar o caminho de erro. Envie por POST um corpo JSON com três números finitos obrigatórios. total_dividends (aliases total_dividend, dividends, dividend_paid e cash_dividends) é o dividendo de caixa agregado em unidades de moeda. Deve ser finito e maior ou igual a zero para que uma companhia que não pagou nada seja permitida. shares_outstanding (aliases shares, number_of_shares, outstanding_shares e shares_issued) é a contagem de ações usada como denominador por ação e deve ser um número finito estritamente maior que zero. share_price (aliases price, stock_price, market_price e last_price) é a cotação na mesma moeda do dividendo e deve ser um número finito estritamente maior que zero. decimals é opcional, um inteiro de zero a doze (padrão seis) que controla o arredondamento half-up do valor por ação e dos dois campos de rentabilidade. Em caso de sucesso o corpo ecoa total_dividends, shares_outstanding e share_price, depois dividend_per_share como o caixa por ação, dividend_yield como porcento, dividend_yield_decimal como a fração equivalente e uma string formula que reescreve que o dividendo por ação é o total sobre as ações e que a rentabilidade é o dividendo por ação sobre o preço. Exemplo: dois bilhões de dividendos totais, quinhentos milhões de ações e um preço de cinquenta devolvem dividend_per_share quatro, dividend_yield oito e dividend_yield_decimal 0.08. Campos ausentes, valores não finitos, um total negativo ou uma contagem ou um preço zero ou negativo falham com invalid_input nomeando o campo e não são cobrados. Prefira números JSON simples a strings com símbolos de moeda ou sinais de porcento; strings numéricas só são aceitas quando batem com um padrão estrito de número finito, sem vírgulas nem rótulos. O preço é um US$ 0,002 fixo por chamada bem-sucedida com unit item.

Onde uma calculadora de dividendos agrega valor

Educadores e plataformas LMS precisam de um oráculo para a pergunta de definição que pede calcular o dividendo por ação a partir do total e das ações em circulação, inclusive o caso de caixa zero, sem um terminal de dados de mercado. Equipes de conteúdo podem contrastar a rentabilidade trailing com a rentabilidade a termo na mesma contagem para o leitor ver por que duas porcentagens podem descrever o mesmo ticker quando a taxa indicada difere do caixa do ano anterior. Use esta capacidade quando você já tem o caixa total, uma contagem de ações e um preço; se tem dólares de cupom anual e um valor de face de título, use uma calculadora de taxa de cupom em vez desta definição de dividendo de renda variável. Arquivos de back-office costumam guardar o total de dividendos pagos, as ações em circulação e o último preço em colunas separadas; um endpoint determinístico recupera DPS e rentabilidade sem uma célula de planilha que alguém depois reescreveria como payout ao dividir pelo lucro. Integradores ligam o endpoint a notebooks, ferramentas de fluxo ou edge workers para fixar goldens quando um extrato de carteira muda o caixa armazenado, a contagem diluída ou a cotação. Mantenha shares_outstanding e share_price estritamente positivos, fixe os campos dividend_per_share e dividend_yield arredondados nos testes e obtenha valores e rentabilidades reproduzíveis para widgets, salas de aula e produção sem montar sua própria biblioteca de pesquisa de renda variável.