Calculateur de dividende

Un nombre d'actions en circulation égal à zéro est rejeté avec invalid_input car il ne peut pas servir de dénominateur.

Ce que signifient le dividende par action et le rendement, et comment le numéraire devient un taux

Cet endpoint n'extrait ni dépôts ni cotations en direct. Il applique les définitions que vous fournissez afin que corrigés, widgets de landing et automatisation partagent un seul montant et un seul taux auditables. total_dividends est le numéraire agrégé que vous voulez au numérateur : dividendes annuels, des douze derniers mois ou le taux annuel indiqué, tant que vous restez cohérent. shares_outstanding est le dénominateur du montant par action et doit être un nombre fini supérieur à zéro ; un nombre nul ne peut pas diviser et est rejeté au lieu d'inventer un dividende. share_price doit être un nombre fini supérieur à zéro afin que le rendement ait un dénominateur valide.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Les actions en circulation sont le champ que le contrat produit met en avant : un nombre zéro n'est jamais remplacé en silence par un, et un nombre manquant n'est pas traité comme zéro. Une validation en échec ne consomme pas le solde, ce qui garde bon marché les scripts exploratoires lorsque vous envoyez volontairement un nombre d'actions zéro pour confirmer le chemin d'erreur. Envoyez par POST un corps JSON avec trois nombres finis obligatoires. total_dividends (alias total_dividend, dividends, dividend_paid et cash_dividends) est le dividende en numéraire agrégé en unités monétaires. Il doit être fini et supérieur ou égal à zéro afin qu'une société qui n'a rien versé soit autorisée. shares_outstanding (alias shares, number_of_shares, outstanding_shares et shares_issued) est le nombre d'actions utilisé comme dénominateur par action et doit être un nombre fini strictement supérieur à zéro. share_price (alias price, stock_price, market_price et last_price) est la cotation dans la même devise que le dividende et doit être un nombre fini strictement supérieur à zéro. decimals est optionnel, un entier de zéro à douze (défaut six) qui pilote l'arrondi half-up du montant par action et des deux champs de rendement. En cas de succès le corps répète total_dividends, shares_outstanding et share_price, puis dividend_per_share comme numéraire par action, dividend_yield en pour cent, dividend_yield_decimal comme fraction équivalente et une chaîne formula qui reformule que le dividende par action égale le total sur les actions et que le rendement égale le dividende par action sur le cours. Exemple : deux milliards de dividendes totaux, cinq cents millions d'actions et un cours de cinquante renvoient dividend_per_share quatre, dividend_yield huit et dividend_yield_decimal 0.08. Champs manquants, valeurs non finies, un total négatif ou un nombre ou un cours nul ou négatif échouent avec invalid_input en nommant le champ et ne sont pas facturés. Préférez des nombres JSON simples aux chaînes avec symboles monétaires ou signes de pour cent ; les chaînes numériques ne sont acceptées que si elles correspondent à un motif strict de nombre fini, sans virgules ni étiquettes. Le tarif est un $0.002 fixe par appel réussi avec unit item.

Où un calculateur de dividende justifie sa place

Enseignants et plateformes LMS ont besoin d'un oracle pour la question de définition qui demande de calculer le dividende par action à partir du total et des actions en circulation, y compris le cas de numéraire nul, sans terminal de données de marché. Les équipes de contenu peuvent opposer le rendement trailing au rendement à terme sur le même nombre d'actions pour que le lecteur voie pourquoi deux pourcentages peuvent décrire un même ticker lorsque le taux indiqué diffère du numéraire de l'année précédente. Utilisez cette capacité lorsque vous avez déjà le numéraire total, un nombre d'actions et un cours ; si vous avez des dollars de coupon annuel et un nominal d'obligation, utilisez un calculateur de taux de coupon plutôt que cette définition de dividende actions. Les fichiers back-office stockent souvent le total des dividendes versés, les actions en circulation et le dernier cours dans des colonnes distinctes ; un endpoint déterministe retrouve le DPS et le rendement sans une cellule de tableur que quelqu'un réécrirait plus tard en payout en divisant par le bénéfice. Les intégrateurs branchent l'endpoint sur des carnets, des outils de flux ou des workers en bordure afin de figer les goldens dès qu'un extrait de portefeuille change le numéraire stocké, le nombre dilué ou la cotation. Comme l'implémentation est un travail analytique parse de palier A pur, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle ni réseau sortant. Gardez shares_outstanding et share_price strictement positifs, figez les champs dividend_per_share et dividend_yield arrondis dans les tests, et vous obtenez des montants et des rendements reproductibles pour widgets, salles de classe et production sans monter votre propre bibliothèque de recherche actions.