配当計算機

発行済株式数がゼロの場合は分母にできないため invalid_input で拒否されます。

1株当たり配当と利回りの意味、キャッシュがレートになる仕組み

本エンドポイントは提出書類もライブ気配も取得しません。total_dividends は分子に置く集計キャッシュです。shares_outstanding は1株金額の分母で、ゼロより大きい有限数でなければなりません。share_price は利回りに有効な分母を与えるため、ゼロより大きい有限数でなければなりません。

入力契約、応答の形、エラー時の振る舞い

何も払わなかった会社を許すため、有限かつゼロ以上でなければなりません。任意の decimals はゼロから十二の整数（既定六）で、1株金額と両方の利回り欄の half-up 丸めを制御します。発行済株式数は製品契約が特に強調する欄です。ゼロ株が黙って一に置き換えられることはなく、欠落した件数もゼロ扱いされません。数値文字列はカンマやラベルのない厳密な有限数パターンに合うときだけ受け付けます。検証失敗は残高を消費しないので、エラー経路を確認するために意図的に株式数ゼロを送る探索スクリプトも安く済みます。POST で JSON 本体に必須の有限数を三つ送ります。total_dividends（別名 total_dividend、dividends、dividend_paid、cash_dividends）は通貨単位の集計現金配当です。shares_outstanding（別名 shares、number_of_shares、outstanding_shares、shares_issued）は1株分母に使う株式数で、ゼロより厳密に大きい有限数でなければなりません。share_price（別名 price、stock_price、market_price、last_price）は配当と同じ通貨の気配で、ゼロより厳密に大きい有限数でなければなりません。成功時は total_dividends、shares_outstanding、share_price をエコーし、1株キャッシュとしての dividend_per_share、パーセントの dividend_yield、同等分数の dividend_yield_decimal、1株配当が総配当÷発行済株式であり利回りが1株配当÷株価であると述べる formula 文字列を返します。例：総配当二十億、発行済五億、株価五十なら dividend_per_share は四、dividend_yield は八、dividend_yield_decimal は 0.08 です。欠落、非有限値、負の合計、ゼロまたは負の株式数や株価はフィールド名付きの invalid_input で失敗し課金されません。通貨記号やパーセント記号付きの文字列より素の JSON 数を使ってください。料金は成功呼び出しあたり固定の $0.002 で unit item です。

配当計算機が効く場面

教育者や LMS は、市場データ端末なしで総配当と発行済株式から1株配当を求める定義問題に、キャッシュゼロの場合も含む答え合わせが必要です。コンテンツチームは同じ株式数でトレーリング利回りとフォワード利回りを対比し、示した年率が前年キャッシュと違うときに二つのパーセントが一つのティッカーを表し得る理由を読者に示せます。総キャッシュ、株式数、株価がすでにあるときに本能力を使ってください。年次クーポンドルと債券額面があるなら、この株式配当の定義ではなくクーポンレート計算機を使います。バックオフィスのファイルは支払済総配当、発行済株式、最終株価を別列に置くことが多く、決定論的なエンドポイントなら、誰かが後から利益で割って配当性向に書き換えてしまう表セルなしで DPS と利回りを戻せます。実装は純 parse ティア A の解析処理のため、成功呼び出しは公開の基本料金 $0.002 のみで、モデルトークンも外向きネットワークもありません。