Use case · News
Media and newsrooms tracking dividend changes and corporate events
Key points
- check_circleevents-feed returns timely disclosures, extraordinary reports, dividend changes, splits and delisting schedules as one date-sorted feed.
- check_circledividend-changes returns increases and cuts detected from earnings summaries, with annual dividends before and after.
- check_circleShowing the data to readers requires Business or higher. Stock prices and TDnet documents themselves may not be published. EDINET documents may be published on Business or higher.
Before, and with ZENITH Code
Before
- removeWatching the timely disclosure list and picking out dividend changes and splits by hand.
- removeCollecting earnings dates from each company's announcements.
- removeLooking into changes in major holders one filing at a time.
With ZENITH Code
- check_circleMarket-wide dividend changes and splits for a date range in one call.
- check_circleEarnings dates for up to 93 days at a time.
- check_circleLarge shareholding reports with each filing, so you can follow holding ratios.
Endpoints to use
A set for daily news gathering and monthly roundups.
- GET
/stable/dividend-changesDividend increase and cut eventsDividend increases and cuts detected from earnings summaries (with annual dividends before and after)10 tokens per call - GET
/stable/events-feedCorporate events feedCombined feed of disclosures, extraordinary reports, dividend changes, splits and delistings10 tokens per call - GET
/stable/earnings-calendarEarnings calendarScheduled and reported earnings dates1 tokens per call - GET
/stable/extraordinary-reportsExtraordinary report eventsExtraordinary reports by reason1 tokens per call - GET
/stable/large-holding-reportsLarge shareholding reports (5%+ filings)Large shareholding and change reports10 tokens per call
Plan fit and what you may show
Showing data to readers in articles, sites or newsletters is providing it to third parties, which requires Business or higher. Internal reporting notes fit Free and Pro.
| Plan | Monthly | Monthly tokens | Showing to third parties (excluding exchange data) |
|---|---|---|---|
| Free | $0 | 5,000 | Not allowed (your own research and analysis, or internal use for a company) |
| Pro | $89 | 100,000 | Not allowed (your own research and analysis, or internal use for a company) |
| BusinessFits this use | $499 | 1,000,000 | Allowed (display in your service, providing processed results, sharing within your organization) |
| EnterpriseFits this use | Custom | Custom | Allowed (display in your service, providing processed results, sharing within your organization) |
Exchange data such as stock prices and price changes may not be published (the Terms do not prevent quoting a very small amount in documents with the source stated). TDnet disclosure documents themselves (PDFs, text and links) may not be republished. Values ZENITH Code extracts, such as dividend changes, are not exchange data.
The Terms are the authoritative source on what you may show or provide. If your use is unclear, contact us before you start. Terms, Article 8 · Pricing
Code example
A market-wide feed of dividend changes and splits (cURL) and a list of dividend increases (Python).
# Dividend changes and stock splits across the market (at most 31 days) curl -sG "https://api.zenithcode.net/stable/events-feed" \ --data-urlencode "types=dividend-change,split" \ --data-urlencode "from=2026-10-13" \ --data-urlencode "to=2026-10-20" \ -H "x-api-key: YOUR_API_KEY"
Things to note
- errorchangeRate and the yields in dividend-changes are 0–1 decimals like every other endpoint (0.1 = 10%). Multiply by 100 when writing them as percentages.
- errorclosePrice in dividend-changes is exchange data. Keep it out of articles.
- errorMarket-wide events-feed calls require from and to, at most 31 days apart.
FAQ for investors and developers
Can I get today's dividend increases the same day?expand_more
Timely disclosures are reflected around 16:30 Japan time. The detection date is normally the TDnet announcement date.
Can articles include PER or dividend yield?expand_more
Valuation metrics ZENITH Code computes are not exchange data and may be shown to readers on Business or higher.
Can I link to disclosure documents?expand_more
Links to TDnet documents (timely disclosure PDFs) count as exchange data and may not be published. EDINET documents (annual securities reports, extraordinary reports, large shareholding reports and others) may be shown or linked in articles on Business or higher.
FAQ for AI builders and researchers
Can an AI draft monthly roundups?expand_more
Give it events-feed and dividend-changes through MCP and it can refer to the same data. For published articles, plan on Business or higher.
How are dividend changes detected?expand_more
From earnings summaries and other timely disclosures. The response includes annual dividends before and after, and the source document ID and title.
How can I check for missed events?expand_more
Compare with disclosures (the timely disclosure list) for the same period.
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