All APIsexpand_more
Dividend streaks
/stable/dividend-streaks1 tokens per callNewReturns the number of consecutive years of dividend increases and of non-decreases (increase or hold). Counts are based on settled annual dividends (split-adjusted, per share) and cross-checked against the progressive dividend years reported in earnings releases, with a flag showing whether they agree. Zero-dividend years stay in the series, so a suspension resets the streak. Targets ordinary stocks; ETFs and REITs follow a calendar-year rule and may disagree. Ratios are 0–1 decimals (0.1 = +10%).
What you can do with this API
- check_circleFind stocks with long dividend-growth records as long-term candidates
- check_circleCheck when a streak was broken by a cut or suspension
- check_circleCompare increase and non-decrease streaks to spot companies that often hold the dividend
Example URL
https://api.zenithcode.net/stable/dividend-streaks?symbol=8113&limit=10Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Required | Securities code (4 characters, e.g. 8113 = Unicharm) | 8113 |
limitnumber | Optional | Number of fiscal years listed in years (newest first, default 10). The streak counts themselves use the whole history (default 10, max 25) | 10 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
Response fields
symbol | string | |
asOf系列の最新の決算期末日（期末到来済みのもの） | string | 系列の最新の決算期末日（期末到来済みのもの） |
latestAnnualDividendannualDividend is the annual dividend for the latest fiscal year (company forecasts included). If there is no annual row, it is interim actual + year-end forecast. | number | annualDividend is the annual dividend for the latest fiscal year (company forecasts included). If there is no annual row, it is interim actual + year-end forecast.How it is calculated → |
consecutiveIncreaseYearsThe API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only). | integer | The API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only).How it is calculated → |
consecutiveNonDecreaseYearsThe API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only). | integer | The API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only).How it is calculated → |
reportedNonDecreaseYearsHow many consecutive recent years the annual dividend was at least the prior year’s. Despite the name, years with an unchanged dividend count. | integer | How many consecutive recent years the annual dividend was at least the prior year’s. Despite the name, years with an unchanged dividend count.How it is calculated → |
matchesReportedThe API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only). | boolean | The API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only).How it is calculated → |
yearsThe API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only). | array | The API builds yearly totals from the dividend history and counts consecutive non-decrease years (unchanged years included) and consecutive increase years (strict increases only).How it is calculated → |
reportedHistoryFY 行ごとの progressive_dividend_years の系列（新しい順） | array | FY 行ごとの progressive_dividend_years の系列（新しい順） |
Related APIs
FAQ
What is the difference between increase and non-decrease streaks?expand_more
The increase streak counts years of raising the dividend every year. The non-decrease streak counts years with an increase or a hold. A held year breaks the first but not the second.
How many tokens does one call use?expand_more
1 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.
Do I need an account to try it?expand_more
Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.
Can I get CSV instead of JSON?expand_more
Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.
Can I get labels in English?expand_more
With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.