Japanese dividend data pitfalls

The per-share dividend changes meaning with every stock split. After a 1-for-5 split, the same total payout is one fifth per share.

Dividend rows also mix company forecasts with confirmed actuals, and per-period rows (interim, year-end) with annual totals. Aggregating without separating them distorts increase and cut detection.

In dividends, amount is split-adjusted and rawAmount is unadjusted (per share as announced). When no adjusted value exists, amount holds the unadjusted value.

Use amount for trends and growth rates. Use rawAmount to check what was actually paid per share at the time.

Split history is available from splits. Toyota split each share into five with an ex-date of September 29, 2021 (effective October 1, 2021).

Dividend rows vary along two axes: forecast or actual, and which period the dividend covers.

dividend-changes returns increases and cuts detected from timely disclosures such as earnings summaries. Each row has the annual dividend before and after, the detection date and the source document ID (sourceDocId).

Omit the symbol to search the whole market over a date range. Use changeFlag=decrease for cuts only.

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 returns the number of consecutive years of increases and of no cuts. The rules are as follows.

• Streaks are counted from the series of annual dividends (per share, split-adjusted) for fiscal years whose period end has passed. Years still in progress are only forecasts and are excluded.
• Increase streak: consecutive years in which the dividend was strictly higher than the year before.
• No-cut streak: consecutive years of an increase or an unchanged dividend. A flat year breaks the increase streak but not the no-cut streak.
• Years with a zero dividend stay in the series, so suspending the dividend resets the count. If the latest year is zero, the no-cut streak is 0.
• A missing calendar year is marked gap, and counting stops there.
• The result is checked against the progressive-dividend years stated in earnings summaries (reportedNonDecreaseYears), and matchesReported shows whether they agree.

Through the fiscal year ended March 2026, Toyota has a 6-year increase streak and a 13-year no-cut streak. The 13 years match the figure in its earnings summary (matchesReported is true).

The 13 years carry capped: true. The count stopped at the oldest year in the dividend data (2013), so the real streak may be longer.

For the fiscal year ending March 2027, an annual dividend forecast of ¥100 (forecast) was announced on May 8, 2026.

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

From the ex-dividend date on, buying the stock no longer entitles you to that period's dividend. It is normally one business day before the record date (period end).

dividends-calendar returns market-wide ex-dividend dates for a range of up to 93 days, covering both past and upcoming dates.

• Commemorative and special dividends: responses currently have no field separating them from ordinary dividends. A year with a one-off dividend can make the next year look like a cut.
• ETFs and REITs: the streak rules are designed for ordinary shares with fiscal-year dividends. The source data counts ETFs and REITs by calendar year, so matchesReported may disagree.
• Comparing across splits: lining up rawAmount makes a split year look like a cut. Use amount for trends.
• History length: how far back data goes varies by stock. For example, Mitsubishi Corporation (8058) has 41 dividend rows from the fiscal year ended March 2013 and a 10-year increase streak.