Use case · Businesses
Investment apps and fintech companies building it into their service
Key points
- check_circleFinancial data merges the earnings summary (preliminary) and the annual securities report (final), with a source for each item.
- check_circleOn Business or higher, you may show the data and processed results (metrics, charts, screening results and so on) to your service's users.
- check_circleStock prices, price changes and TDnet disclosure documents themselves (PDFs, text and links) may not be shown to users.
Before, and with ZENITH Code
Before
- removeBuilding and maintaining your own pipeline to extract figures from filings, chasing format changes and corrections.
- removeReconciling the same item under different names across Japanese GAAP, IFRS and US GAAP.
- removeRecomputing sector averages and other aggregates in-house.
With ZENITH Code
- check_circleIncome statements, balance sheets and cash flows arrive with field names unified across accounting standards.
- check_circleTimely disclosures are reflected around 16:30 and EDINET filings around 19:00 Japan time, and the API reports data freshness.
- check_circleSector medians, quartiles and peer comparisons arrive as computed aggregates.
Endpoints to use
A set for company pages, dividend pages, news feeds and peer comparison screens.
- GET
/stable/income-statementIncome statementEarnings history (summary and annual report merged, with sources)1 tokens per call - GET
/stable/key-metricsKey financial metrics (per period)ROE, margins, payout ratio and other metrics1 tokens per call - GET
/stable/dividendsDividend historyDividend history and forecasts1 tokens per call - GET
/stable/events-feedCorporate events feedFeed of dividend changes, splits, extraordinary reports and more (links to TDnet documents may not be shown)10 tokens per call - GET
/stable/peersPeer comparisonPeer comparison tables10 tokens per call - GET
/stable/industry-benchmarksIndustry benchmarks by sectorSector medians and quartiles10 tokens per call
Plan fit and what you may show
Showing data to your service's users requires a Business plan or higher.
| 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) |
Even on Business, stock prices, values in the same unit (OHLC, moving averages, price changes and so on) and TDnet disclosure documents themselves (PDFs, text and links) may not be shown. Redistributing the data itself as an API, file or data feed requires our prior written consent.
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
Fetch income and metrics on the server and shape them for your screens (JavaScript). Never send the API key to the browser.
curl -sG "https://api.zenithcode.net/stable/income-statement" \ --data-urlencode "symbol=7203" \ --data-urlencode "period=annual" \ --data-urlencode "limit=5" \ -H "x-api-key: YOUR_API_KEY"
Things to note
- errorIn events-feed, the url of timely disclosures (type=disclosure) links to TDnet documents (PDFs). That is exchange data, so do not show it to users (the link is present only for Japanese documents within 30 days of release; otherwise it is null). The url of extraordinary reports (type=extraordinary) points to EDINET documents, which you may show on Business or higher.
- errorclosePrice in dividend-changes (the close used to compute yields) is also exchange data.
- errorUse the API key on the server only and keep it out of browser code.
FAQ for investors and developers
Can my app show PER or dividend yield?expand_more
Yes, on Business or higher. Valuation metrics ZENITH Code computes from prices and financial figures are not exchange data.
Can my app show stock price charts?expand_more
No. Stock prices and values in the same unit are exchange data and may not be shown to third parties on any plan.
Can I make a large number of calls?expand_more
Business includes 1,000,000 tokens a month at 300 requests per minute. Contact us about Enterprise if you need more.
FAQ for AI builders and researchers
Can an in-app AI assistant use the data?expand_more
On Business or higher, you may let AI agents refer to the data at your users' request. Exchange data may not be given to users in AI responses.
Can I show the source of figures?expand_more
provenance in income-statement and similar endpoints holds the source (TDnet or EDINET) and document ID. Show sources within the Terms.
Can I detect delayed updates?expand_more
A dataset with stale: true in /stable/system/freshness has missed its schedule. You can build that into your monitoring.
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