Track large shareholdings

/stable/large-holding-reports returns large shareholding and change reports one filing at a time. Put the previous and current holding ratios side by side to follow changes.

Key points

check_circleFilter by issuer (symbol), filer (holder, an EDINET code) or date range.
check_circleholdingRatio (current) and holdingRatioPrev (previous) are 0–1 decimals.
check_circleEach call uses 10 tokens. The yearly list is /stable/large-holders (1 token).

Endpoints to use

Code

Replace YOUR_API_KEY with a key issued in your dashboard. Switch languages with the tabs.

Code example

curl -sG "https://api.zenithcode.net/stable/large-holding-reports" \
  --data-urlencode "symbol=7203" \
  --data-urlencode "includeHolders=false" \
  --data-urlencode "limit=20" \
  -H "x-api-key: YOUR_API_KEY"

How the code works

1Call with symbol, and includeHolders=false if you do not need the breakdown.
2Show filingDate, filer.name, reportKind (initial or change) and the previous and current ratios.
3Check changeReason for the reason, such as additional purchases or disposals.

Things to note

errorWithout symbol or holder, the date range (from and to) is at most 93 days.
errorFor amended filings, only the latest version of each filing set is returned.
errorHistorical filings currently focus on listed filers. Check the coverage field.

FAQ for investors and developers

What is the 5% rule?expand_more

Holders must file a large shareholding report when they own more than 5% of a listed company, and a change report when the ratio later moves by 1 point or more, among other cases.

Can I follow a specific institution?expand_more

Pass the filer's EDINET code (E followed by five digits) as holder to get its reports.

FAQ for AI builders and researchers

What unit are the ratios in?expand_more

0–1 decimals (0.0159 = 1.59%). ratio in large-holders and major-shareholders uses the same unit.

What is the source?expand_more

Reports filed on EDINET. Responses include the document ID and a link to the original.

gavel

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