Get free API key
All APIsexpand_more
search
appsAll APIs
functionHow metrics are calculated

Dividend increase and cut events

GET/stable/dividend-changes10 tokens per call

Returns 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=100

Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.

Parameters

ParameterRequiredDescriptionExample
symbol
string
OptionalSecurities code (4 characters). Omit for the whole market7203
from
string
OptionalStart date (YYYY-MM-DD), lower bound of the detection date2026-04-01
to
string
OptionalEnd date (YYYY-MM-DD), upper bound of the detection date2026-06-30
changeFlag
select
Optionalincrease for dividend increases only, decrease for cuts only. Omit for both
Allowed values: increase, decrease
increase
limit
number
OptionalMaximum 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 Viewer

Response example (real data)

lock
Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view

Response fields

symbolstring
changeFlagincrease=増配 / decrease=減配stringincrease=増配 / 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%).numberAnnual 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%).numberAnnual 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%).numberAnnual 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%).numberAnnual 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%).numberAnnual 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利回り計算に使った終値
priceDatestring
sourceDocId出典 TDnet 書類の doc_idstring出典 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.