無料でAPIキー取得
すべての APIexpand_more
search
appsすべての API
function指標の計算方法

配当履歴

GET/stable/dividends1 回 1 トークン人気

銘柄ごとの配当の履歴を新しい順に返します。会社が発表した予想配当も含まれます。1 株当たり配当は円です。

この API でできること

  • check_circle過去の配当の推移を確認して安定性を見る
  • check_circle今期の予想配当を確認して配当利回りを試算する
  • check_circle保有銘柄の配当を一覧にして年間の受取額を見積もる

例の URL

https://api.zenithcode.net/stable/dividends?symbol=7203&limit=40

読みやすいように符号化せずに表示しています。日本語などの値は、送るときに自動で符号化されます。

パラメータ

引数必須説明例
symbol
string
必須証券コード(4 桁。例: 7203 = トヨタ自動車。130A のような英字入りも可)7203
limit
number
任意返す件数の上限(既定 40、最大 100)40

試してみる

自分の条件で実行して、応答を表・JSON・CSV で確かめられます。ログインが必要で、実行するたびに 1 トークンを使います。

travel_exploreAPI ビューワーで試す

応答の例(実データ)

lock
実データの応答例は、ログインした方だけに表示しています(株価などの取引所データを含むため)。 ログインして見る

レスポンス項目

symbol証券コード(4 桁)string証券コード(4 桁)
periodEndDate権利確定基準日(期末)string権利確定基準日(期末)
periodType基準日の区分(Q1 / Q2 / Q3 / FY)string基準日の区分(Q1 / Q2 / Q3 / FY)
exDividendDate権利落ち日string権利落ち日
paymentDate支払日string支払日
announcementDate公表日時(決算短信・配当予想の修正の発表)string公表日時(決算短信・配当予想の修正の発表)
amount1 株当たり配当(円・株式分割調整後。未調整しかない場合は未調整額)number1 株当たり配当(円・株式分割調整後。未調整しかない場合は未調整額)計算方法 →
rawAmount1 株当たり配当(円・開示どおりの未調整額)number1 株当たり配当(円・開示どおりの未調整額)計算方法 →
currency通貨(JPY)string通貨(JPY)
dividendType配当の種類。annual = 年間合計の行、quarterly など = 各回の配当(年間合計と各回が両方あるので合算に注意)string配当の種類。annual = 年間合計の行、quarterly など = 各回の配当(年間合計と各回が両方あるので合算に注意)
forecastOrActualforecast=予想 / actual=実績stringforecast=予想 / actual=実績
dataSource出典(TDnet など)string出典(TDnet など)

関連する API

よくある質問

1 回の呼び出しでトークンをいくつ使いますか?expand_more

1 トークンです。件数や期間によらず、1 回の呼び出しごとに同じ数を使います。月の上限はプランによって決まります。

試すのに登録は必要ですか?expand_more

API ビューワーで、自分の条件で実行して応答を確かめられます。無料登録してログインしてください(クレジットカード不要)。実行するたびに、この API のトークンを使います。

CSV で受け取れますか?expand_more

URL に format=csv を付けると CSV で返ります。表計算ソフトや pandas にそのまま読み込めます。

英語で受け取れますか?expand_more

lang も Accept-Language も無いと、業種名などの label は英語で返ります。日本語にするには lang=ja を付けるか、Accept-Language: ja を送ります。企業名・業種名は nameJa / nameEn、sectorJa / sectorEn のように両方の項目で常に返ります。項目名は日英とも同じです。