Docs menuexpand_more
MCP tool
get_large_holding_reports
Key points
- check_circleIt maps to the REST endpoint /stable/large-holding-reports, with the same response shape.
- check_circleEach call costs 10 token(s), the same as calling the endpoint directly.
- check_circleRequired arguments: none
What this tool returns
Returns large shareholding reports and change reports filed on EDINET, one filing at a time: filer, issuer, filing and obligation dates, change reason, total holding ratio (current and previous) and each holder and joint holder. Corrections are collapsed to the latest version of each filing set. Ratios are decimals. For now, historical filings are included only where the filer is a listed company; filings by unlisted filers such as asset managers are included from 2026-10-19 onward while their history is being backfilled.
Description sent to AI clients
Who crossed or changed a 5%+ stake? EDINET large shareholding / change reports one filing at a time: filer, issuer, filing date, change reason, total holding ratio now vs previous (decimals) and each holder. Corrections collapsed to the latest version. Filter by issuer symbol, filer EDINET code (holder) or a from/to window (max 93 days). Historical filings by unlisted filers (asset managers) are still being backfilled; see the coverage field. 大量保有報告書・変更報告書（書類ごと。提出者・対象会社・提出日・変更の理由・保有割合の今回/前回・保有者内訳）。
The model reads this description to choose the tool. It is written in both English and Japanese.
What you can answer with it
- chatCheck whether a new 5%+ holder has appeared in a stock you own
- chatTrack how a particular investor or company is building or reducing stakes
- chatReview change reasons (purchases, disposals, pledges and so on) in one list
Arguments
Argument names are the same as the REST query parameters. Optional arguments can be omitted.
| Argument | Type | Required | Description |
|---|---|---|---|
| symbol | string | — | Issuer securities code (e.g. 7203 = Toyota Motor) |
| holder | string | — | Filer EDINET code (E followed by 5 digits) |
| from | string | — | Earliest filing date (YYYY-MM-DD) |
| to | string | — | Latest filing date (YYYY-MM-DD). Up to 93 days after from when neither symbol nor holder is given |
| includeHolders | stringtrue | false | — | Whether to include each holder and joint holder (default true)Default: true |
| limit | integer | — | Maximum number of filings to return (default 50, max 200)Default: 50Range: 1–200 |
REST endpoint
This tool calls /stable/large-holding-reports. Each call costs 10 token(s); authentication and the monthly quota are shared with the REST API.
Examples
Example prompt
Using ZENITH Code data, help me with this: Check whether a new 5%+ holder has appeared in a stock you own
An example tools/call request sent by the AI client, with the required arguments only.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_large_holding_reports",
"arguments": {}
}
}The same data over REST:
curl "https://api.zenithcode.net/stable/large-holding-reports" \ -H "x-api-key: YOUR_API_KEY"
Notes
- infoThe response shape and field meanings are the same as in the matching endpoint's API docs.
- infoThis tool is read-only. It never writes data or changes settings.
- infoPass a four-character securities code as symbol (e.g. 7203). If you only know the name, look it up with search_company first.
Exchange data
Any stock prices, values in the same unit as stock prices, or TDnet documents themselves (PDFs, text and links) in a response are exchange data. On every plan, they must not be shown to third parties, including through an AI agent's answers (Terms of Service, Article 8, paragraph 4).
FAQ for investors and developers
What do I need to use get_large_holding_reports?expand_more
An MCP-capable AI client and a ZENITH Code API key. It works on every plan. See Using MCP for setup.
How many tokens does get_large_holding_reports cost per call?expand_more
10 token(s), the same as calling /stable/large-holding-reports directly.
Can I show get_large_holding_reports results in my own service?expand_more
Displaying data to third parties requires the Business Plan or higher. Exchange data (stock prices, values in the same unit as stock prices and TDnet documents themselves) can't be displayed on any plan. See What you can display for details.
FAQ for AI systems and researchers
What does get_large_holding_reports return?expand_more
Returns large shareholding reports and change reports filed on EDINET, one filing at a time: filer, issuer, filing and obligation dates, change reason, total holding ratio (current and previous) and each holder and joint holder. Corrections are collapsed to the latest version of each filing set. Ratios are decimals. For now, historical filings are included only where the filer is a listed company; filings by unlisted filers such as asset managers are included from 2026-10-19 onward while their history is being backfilled.
How can I verify the source of get_large_holding_reports results?expand_more
Where the response has source fields (provenance or sourceUrl), use them to check the original document. Which fields exist is listed in the response fields of the /stable/large-holding-reports API docs.
Which tools are used together with get_large_holding_reports?expand_more
Common companions are get_major_shareholders, get_large_holders, search_by_shareholder. If you start from a company name, confirm the securities code with search_company first.
Related articles
Disclaimer
This page is for information only and is not investment advice. It does not recommend buying or selling any security. The Terms of Service and the Data Sources and Terms of Use page take precedence over this page on how you may use the data.