Get free API key
Docs menuexpand_more
travel_exploreTry in the API Viewer

Guides

Endpoints

search
appsAll APIs
functionHow metrics are calculated

Cookbook

Chart dividend history

/stable/dividend-streaks returns annual dividends per fiscal year (split-adjusted, per share) and streaks of increases and non-decreases. This recipe turns them into a bar chart.

Key points

  • check_circleyears lists annual dividends newest first. Reverse it for the chart.
  • check_circleThe same response includes increase and non-decrease (increase or hold) streaks.
  • check_circleEach call uses 1 token. The example is Mitsubishi Corporation (8058).

Endpoints to use

Code

Replace YOUR_API_KEY with a key issued in your dashboard. Switch languages with the tabs.

Code example
# Annual dividends per fiscal year (split-adjusted, newest first)
curl -sG "https://api.zenithcode.net/stable/dividend-streaks" \
  --data-urlencode "symbol=8058" \
  --data-urlencode "limit=15" \
  -H "x-api-key: YOUR_API_KEY"

How the code works

  1. 1Call with symbol and limit (fiscal years listed in years, up to 25).
  2. 2Reverse years in the first row and chart year against annualDividend.
  3. 3Check consecutiveIncreaseYears and consecutiveNonDecreaseYears for the streaks.

Things to note

  • errorAnnual dividends are for fiscal years that have ended. Check this year's forecast in the forecast rows of /stable/dividends.
  • errorYears with no dividend stay in the series, so a suspension ends the streak.
  • errorETFs and REITs follow a calendar-year rule and may not match company announcements.

FAQ for investors and developers

What is the difference between increase and non-decrease streaks?expand_more

An increase streak counts years of raising the dividend every year; a non-decrease streak counts years of raising or holding it.

What happens to amounts after a stock split?expand_more

Annual dividends are split-adjusted per share, so the history is comparable across splits.

FAQ for AI builders and researchers

Are the streaks checked against company reports?expand_more

They are compared with the progressive dividend years in earnings summaries, and matchesReported shows whether they agree.

Where does the chart data come from?expand_more

Dividend data collected from disclosures such as earnings summaries. Each year's basis shows which row it was counted from.

gavel

Disclaimer

This page explains how to use a Japanese equity data API and how its data is defined. It is not a solicitation to invest or a recommendation to buy or sell any security. The content reflects information at the time of writing and is not guaranteed to be accurate or complete. Investment decisions are your own responsibility.

What you may show or provide to third parties depends on your plan and Article 8 of the Terms. Exchange data such as stock prices may not be shown to third parties on any plan. Terms, Article 8 · Data sources and terms of use