All APIsexpand_more
Dividend increase and cut events
/stable/dividend-changes10 tokens per callReturns dividend increases and cuts detected from earnings releases (Kessan Tanshin), with the previous and new annual dividend, change rate, implied yields and the source document. Omit symbol to scan the whole market. As in other endpoints, the change rate and yields are 0–1 decimals (0.1 = 10%).
What you can do with this API
- check_circleFind stocks that recently raised dividends across the market
- check_circleCheck which of your holdings cut their dividend
- check_circleRank by increase rate to build a watch list
Example URL
https://api.zenithcode.net/stable/dividend-changes?symbol=7203&from=2026-04-01&to=2026-06-30&changeFlag=increase&limit=100Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.
Parameters
| Parameter | Required | Description | Example |
|---|---|---|---|
symbolstring | Optional | Securities code (4 characters). Omit for the whole market | 7203 |
fromstring | Optional | Start date (YYYY-MM-DD), lower bound of the detection date | 2026-04-01 |
tostring | Optional | End date (YYYY-MM-DD), upper bound of the detection date | 2026-06-30 |
changeFlagselect | Optional | increase for dividend increases only, decrease for cuts only. Omit for both Allowed values: increase, decrease | increase |
limitnumber | Optional | Maximum number of rows to return (default 100, max 500) | 100 |
Try it
Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 10 tokens.
travel_exploreTry in the API ViewerResponse example (real data)
Response fields
symbol | string | |
changeFlagincrease=増配 / decrease=減配 | string | increase=増配 / decrease=減配 |
detectedDate検知日(原則 TDnet 発表日の JST 日付) | string | 検知日(原則 TDnet 発表日の JST 日付) |
announcementDate短信の発表日時 | string | 短信の発表日時 |
targetPeriodEndDate対象期末日 | string | 対象期末日 |
previousAnnualDividendAnnual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%). | number | Annual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%).How it is calculated → |
newAnnualDividendAnnual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%). | number | Annual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%).How it is calculated → |
changeRateAnnual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%). | number | Annual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%).How it is calculated → |
previousDividendYieldAnnual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%). | number | Annual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%).How it is calculated → |
newDividendYieldAnnual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%). | number | Annual dividend changes detected in kessan tanshin and similar filings. As with every other ratio, the change rate and yields are 0–1 decimals (0.1 = 10%).How it is calculated → |
closePrice利回り計算に使った終値 | number | 利回り計算に使った終値 |
priceDate | string | |
sourceDocId出典 TDnet 書類の doc_id | string | 出典 TDnet 書類の doc_id |
sourceUrl出典の PDF(ZENITH Code の配信経路 /stable/filing-document。API キーが要る) | string | 出典の PDF(ZENITH Code の配信経路 /stable/filing-document。API キーが要る) |
sourceTitle出典書類タイトル | string | 出典書類タイトル |
Related APIs
FAQ
How many tokens does one call use?expand_more
10 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.

