配当データの落とし穴

配当の 1 株当たりの金額は、株式分割のたびに意味が変わります。1 株を 5 株に分けると、同じ配当総額でも 1 株当たりは 5 分の 1 になります。

さらに配当の行には、会社の予想と確定した実績、中間・期末などの期ごとの行と年間の合計の行があります。これらを区別せずに集計すると、増配・減配の判定がずれます。

dividends の amount は分割調整後、rawAmount は調整前（発表時点の 1 株当たり）の配当です。調整済みの値が無い行は、amount に調整前の値が入ります。

過去の推移や増配率を見るときは amount を使います。当時の受取額を確かめたいときは rawAmount を使います。

分割の履歴は splits で取れます。トヨタ自動車は 2021 年 9 月 29 日を権利落ち日として、1 株を 5 株に分割しました（効力発生は 2021 年 10 月 1 日）。

配当の行は、予想か実績かと、どの期間の配当かの 2 つの軸で分かれます。

dividend-changes は、決算短信などの適時開示から検知した増配・減配を返します。変更前と変更後の年間配当、検知日、出典の書類 ID（sourceDocId）が付きます。

銘柄を省略すると、市場全体から期間を指定して探せます。changeFlag=decrease で減配だけに絞れます。

curl -sG "https://api.zenithcode.net/stable/dividend-changes" \
  --data-urlencode "from=2026-09-01" \
  --data-urlencode "to=2026-09-30" \
  --data-urlencode "changeFlag=decrease" \
  -H "x-api-key: YOUR_API_KEY"

dividend-streaks は、連続増配と連続非減配の年数を返します。数え方は次のとおりです。

• 期末が来た決算期の年間配当（1 株当たり・分割調整後）を並べた系列から数えます。期末が来ていない期は会社予想にすぎないので含めません。
• 連続増配 は、前の期より厳密に増えた年が続いた回数です。
• 連続非減配 は、増配または据え置きが続いた回数です。据え置きの年は、連続増配は途切れますが、連続非減配は続きます。
• 無配（0 円）の年も系列に残します。無配になるとそこで年数がリセットされます。直近が無配なら連続非減配は 0 です。
• 暦年が飛んでいる（データが欠けている）年は gap とし、そこで数えるのを止めます。
• 決算短信に載る累進配当の年数（reportedNonDecreaseYears）とも照合し、一致するかを matchesReported で示します。

トヨタ自動車は、2026 年 3 月期までで連続増配 6 年、連続非減配 13 年です。短信に載る年数（13 年）とも一致しています（matchesReported が true）。

ただし 13 年には capped: true が付いています。配当データを遡れる最古の年（2013 年）で打ち切った値で、実際はもっと長い可能性があります。

2027 年 3 月期の配当は、年間 100 円の予想（forecast）が 2026 年 5 月 8 日に発表されています。

curl -sG "https://api.zenithcode.net/stable/dividend-streaks" \
  --data-urlencode "symbol=7203" \
  -H "x-api-key: YOUR_API_KEY"

権利落ち日は、その日以降に買っても、その期の配当を受け取れなくなる日です。通常は権利確定日（期末）の 1 営業日前です。

dividends-calendar で、市場全体の権利落ち日を期間（最大 93 日）を指定して取れます。過去分と今後の予定のどちらも対象です。

• 記念配当・特別配当: 普通配当と分けて返す項目は、今の応答にはありません。一時的な配当が含まれる年は、翌年が減配に見えることがあります。
• ETF・REIT: 連続年数の数え方は普通株（決算期ごと）向けです。ETF・REIT は元データが暦年の規則で数えているため、matchesReported が一致しないことがあります。
• 分割をまたぐ比較: rawAmount を並べると、分割の年に減配したように見えます。推移には amount を使ってください。
• 履歴の長さ: 遡れる範囲は銘柄によって違います。例として、三菱商事（8058）の配当は 2013 年 3 月期から 41 件あり、連続増配は 10 年です。