すべての APIexpand_more
連続増配・連続非減配の年数
/stable/dividend-streaks1 回 1 トークン新着連続増配の年数と、連続非減配（増配または据え置き）の年数を返します。期末が到来済みの年間配当（分割調整後・1 株当たり）の系列から数え、決算短信に載る累進配当の年数とも照合して一致するかを示します。無配の年も系列に残るため、無配になるとそこで年数がリセットされます。普通株が対象で、ETF・REIT は暦年ルールのため一致しないことがあります。比率は 0〜1 の小数（0.1 = +10%）です。
この API でできること
- check_circle連続増配年数の長い銘柄を見つけて長期保有の候補にする
- check_circle減配や無配で連続記録が途切れた時期を確認する
- check_circle連続増配と連続非減配の差から、据え置きが多い会社かを見分ける
例の URL
https://api.zenithcode.net/stable/dividend-streaks?symbol=8113&limit=10読みやすいように符号化せずに表示しています。日本語などの値は、送るときに自動で符号化されます。
パラメータ
| 引数 | 必須 | 説明 | 例 |
|---|---|---|---|
symbolstring | 必須 | 証券コード（4 桁。例: 8113 = ユニ・チャーム） | 8113 |
limitnumber | 任意 | years に載せる決算期の数（新しい順、既定 10）。連続年数そのものは全期間から数えます（既定 10、最大 25） | 10 |
試してみる
自分の条件で実行して、応答を表・JSON・CSV で確かめられます。ログインが必要で、実行するたびに 1 トークンを使います。
travel_exploreAPI ビューワーで試す応答の例（実データ）
レスポンス項目
symbol | string | |
asOf系列の最新の決算期末日（期末到来済みのもの） | string | 系列の最新の決算期末日（期末到来済みのもの） |
latestAnnualDividend最新の決算期の年間配当（円） | number | 最新の決算期の年間配当（円）計算方法 → |
consecutiveIncreaseYears連続増配年数（前の決算期より厳密に増えた年が続いた回数） | integer | 連続増配年数（前の決算期より厳密に増えた年が続いた回数）計算方法 → |
consecutiveNonDecreaseYears連続非減配年数（増配または据え置きが続いた回数。stock-cloud-api と同じ規則で自前計算） | integer | 連続非減配年数（増配または据え置きが続いた回数。stock-cloud-api と同じ規則で自前計算）計算方法 → |
reportedNonDecreaseYearsバッチが書いた連続非減配年数（最新の FY 行の progressive_dividend_years） | integer | バッチが書いた連続非減配年数（最新の FY 行の progressive_dividend_years）計算方法 → |
matchesReportedconsecutiveNonDecreaseYears が reportedNonDecreaseYears と一致するか。報告値が無ければ null | boolean | consecutiveNonDecreaseYears が reportedNonDecreaseYears と一致するか。報告値が無ければ null計算方法 → |
years決算期ごとの年間配当（新しい順）。limit 件まで | array | 決算期ごとの年間配当（新しい順）。limit 件まで計算方法 → |
reportedHistoryFY 行ごとの progressive_dividend_years の系列（新しい順） | array | FY 行ごとの progressive_dividend_years の系列（新しい順） |
関連する API
よくある質問
連続増配と連続非減配の違いは？expand_more
連続増配は毎年増やし続けた年数、連続非減配は増配か据え置きで減らさなかった年数です。据え置きの年があると、連続増配は途切れますが連続非減配は続きます。
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 のように両方の項目で常に返ります。項目名は日英とも同じです。