Use case · Individuals
Individual investors and developers analyzing for themselves
Key points
- check_circleLook up securities codes by company name, then fetch income and dividend history in bulk.
- check_circleAdd ?format=csv to load the data straight into Google Sheets or Excel.
- check_circleYour own research and analysis fits Free and Pro. Publishing a tool you build for others requires Business or higher.
Before, and with ZENITH Code
Before
- removeOpening each earnings PDF or annual report and copying numbers into a spreadsheet by hand.
- removeCollecting dividend history and counting consecutive increases yourself.
- removeSwitching between several sites just to find a company's securities code.
With ZENITH Code
- check_circleOne call returns income statements by fiscal period, with the source (earnings summary or annual report) for each item.
- check_circleConsecutive increase and non-decrease streaks come computed from split-adjusted annual dividends.
- check_circleSearch by part of a company name to get the securities code and use it in the next call.
Endpoints to use
These five endpoints cover looking up, importing and filtering.
- GET
/stable/search-nameSearch companies by nameFind a securities code from part of a company name1 tokens per call - GET
/stable/income-statementIncome statementRevenue, operating income and net income by fiscal period1 tokens per call - GET
/stable/dividendsDividend historyDividend history and company forecasts1 tokens per call - GET
/stable/dividend-streaksDividend streaksIncrease and non-decrease streaks and annual dividends1 tokens per call - GET
/stable/screenerStock screenerFilter stocks by ROE, dividend yield and other conditions10 tokens per call
Plan fit and what you may show
Using the data for your own research, analysis and investment decisions is Basic Use, available on Free and Pro. Choose by the number of monthly tokens you need.
| Plan | Monthly | Monthly tokens | Showing to third parties (excluding exchange data) |
|---|---|---|---|
| FreeFits this use | $0 | 5,000 | Not allowed (your own research and analysis, or internal use for a company) |
| ProFits this use | $89 | 100,000 | Not allowed (your own research and analysis, or internal use for a company) |
| Business | $499 | 1,000,000 | Allowed (display in your service, providing processed results, sharing within your organization) |
| Enterprise | Custom | Custom | Allowed (display in your service, providing processed results, sharing within your organization) |
Sharing or publishing a spreadsheet or tool you built counts as providing the data to third parties, which Free and Pro do not allow. Exchange data such as stock prices may not be shown to others on any plan.
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
Check dividend growth streaks for your holdings (Python). There are cURL and Google Sheets tabs too.
curl -sG "https://api.zenithcode.net/stable/dividend-streaks" \ --data-urlencode "symbol=8113" \ -H "x-api-key: YOUR_API_KEY"
Things to note
- errorRatios such as ROE and dividend yield are 0–1 decimals in the API. 0.0323 means 3.23%.
- errornull means "not disclosed" or "cannot be computed", not zero.
- errorStock prices and price changes require an account (sign-in).
FAQ for investors and developers
Can I use it without programming?expand_more
Yes. Paste the code example from any endpoint's documentation into Google Sheets Apps Script or Excel Power Query to load the data into a table.
Is the Free plan enough?expand_more
Free includes 5,000 tokens a month, so a 1-token endpoint can be called 5,000 times. That is often enough to check your holdings; upgrade to Pro if not.
Can friends use a tool I built?expand_more
Free and Pro do not allow making the data available to third parties. Sharing requires Business or higher.
FAQ for AI builders and researchers
Can an AI such as Claude help with my analysis?expand_more
Yes. MCP-compatible AI clients can use the same data through 72 tools. Use by an AI you yourself use is Basic Use.
How do I check how current the data is?expand_more
/stable/system/freshness shows each dataset's as-of time and whether it is stale. It needs no key and uses no tokens.
Can I see where income figures come from?expand_more
The provenance field of income-statement holds the source (TDnet or EDINET) and the document ID.
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