All APIsexpand_more

Shareholding by shareholder category

GET/stable/shareholder-categories1 tokens per call

From the annual securities report, returns the number of shareholders, shares held and shareholding ratio for governments, financial institutions, securities firms, other corporations, foreign investors and individuals. Shares are counted in trading units, not individual shares, and ratios are 0–1 decimals. Treasury shares are not broken out here; see /stable/treasury-shares.

What you can do with this API

check_circleFind stocks with a high foreign-investor ownership ratio
check_circleTell apart retail-heavy and institution-heavy companies
check_circleTrack changes in the shareholder mix year by year

Example URL

https://api.zenithcode.net/stable/shareholder-categories?symbol=7203&fiscalPeriod=2026-03

Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.

Parameters

Parameter	Required	Description	Example
`symbol` string	Required	Securities code (4 characters, e.g. 7203 = Toyota Motor; alphanumeric codes such as 130A also work)	`7203`
`fiscalPeriod` string	Optional	Fiscal period (YYYY-MM, e.g. 2026-03 = fiscal year ending March 2026). Defaults to the latest	`2026-03`

Try it

Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 tokens.

travel_exploreTry in the API Viewer

Response example (real data)

lock

Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view

Response fields

`symbol`	string
`fiscalPeriod`	string
`period`	string
`docId`	string
`docTypeCode`	string
`submittedAt`	string
`sourceUrl`EDINET原本へのリンク	string	EDINET原本へのリンク
`classes`株式の種類（コンテキスト）ごとの所有者別状況。ふつうは 1 件	array	株式の種類（コンテキスト）ごとの所有者別状況。ふつうは 1 件

Related APIs

Major shareholders (top 10)

/stable/major-shareholders

Treasury shares (voting-rights disclosure)

/stable/treasury-shares

Find companies by shareholder nameBusiness+

/stable/shareholder-search

FAQ

Why are the share numbers smaller than I expected?expand_more

They are counted in trading units (usually 1 unit = 100 shares), not single shares. Multiply by the unit size to get shares.

How many tokens does one call use?expand_more

1 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.

Do I need an account to try it?expand_more

Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.

Can I get CSV instead of JSON?expand_more

Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.

Can I get labels in English?expand_more

With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.