株主

日本の開示では株主の情報が複数の書類に分かれています。jfinance はこれらを統合せず、書類ごとに分けて返します。

属性	出所
`major_holders`	有価証券報告書「所有者別状況」
`major_shareholders`	有価証券報告書「大株主の状況」
`institutional_holders`	大量保有報告書（特例対象株券等）
`insider_roster_holders`	有価証券報告書「役員の状況」
`large_holders`、`large_holder_transactions`、`large_holder_activity`、`large_holding_reports`	大量保有報告書

有価証券報告書に基づく情報

Ticker.major_holders -> pandas.DataFrame
Ticker.get_major_holders(as_dict=False) -> pandas.DataFrame | dict

有価証券報告書の「所有者別状況」に基づく、区分ごとの所有割合を返します。2019 年度の有価証券報告書から取得できます。

引数

名前	型	既定値	説明
`as_dict`	`bool`	`False`	`DataFrame` ではなく `dict` で返す

戻り値 — pandas.DataFrame。列は Value の 1 列で、行は次のキーです。

行	型	説明
`institutionsPercentHeld`	`float`	金融機関＋証券会社＋外国法人
`institutionsCount`	`float`	その所有者数
`insidersPercentHeld`	`float`	役員の所有分
`financialInstitutionsPercentHeld`	`float`	金融機関
`financialServiceProvidersPercentHeld`	`float`	証券会社
`otherCorporationsPercentHeld`	`float`	その他の法人
`foreignCorporationsPercentHeld`	`float`	外国法人
`foreignIndividualsPercentHeld`	`float`	外国人個人
`individualsAndOthersPercentHeld`	`float`	個人その他
`asOfDate`	`int`	基準日。UNIX 秒
`sourceDocumentId`	`str`	EDINET の書類管理番号

割合は小数で表します（0.8669 は 86.69%）。役員の所有株式数の単位が書類から読み取れない場合、 insidersPercentHeld は返しません。値を推測して補完することはありません。

Ticker.major_shareholders -> pandas.DataFrame
Ticker.get_major_shareholders(as_dict=False, year=None) -> pandas.DataFrame | dict

有価証券報告書に記載される上位 10 名の大株主を返します。名義ベースであるため信託口が上位に並びます。実質的な所有者の一覧ではありません。

引数

名前	型	既定値	説明
`as_dict`	`bool`	`False`	`DataFrame` ではなく `dict` で返す
`year`	`int`	`None`	有価証券報告書の年度。省略時は最新。指定できる年度は `.attrs["years"]` で確認できる

戻り値 — pandas.DataFrame。1 名につき 1 行です。

Ticker.insider_roster_holders -> pandas.DataFrame
Ticker.get_insider_roster_holders(as_dict=False) -> pandas.DataFrame | dict

有価証券報告書に基づく役員とその所有株式数を、yfinance の列名で返します。

戻り値 — pandas.DataFrame

列	型	説明
`Name`	`str`	氏名。提出書類の記載どおり
`Position`	`str`	役職
`Shares Owned Directly`	`int`	所有株式数
`Position Direct Date`	`datetime64`	基準日
`URL`、`Most Recent Transaction`、`Latest Transaction Date`	—	yfinance との互換性を保つために設けた列で、常に空。EDINET には役員の売買の開示がない

大量保有報告書は 5% ルールに基づき、会社ではなく保有者が提出します。機関投資家に限らず、事業会社や個人も提出します。

Ticker.institutional_holders -> pandas.DataFrame
Ticker.get_institutional_holders(as_dict=False) -> pandas.DataFrame | dict

機関投資家向けの特例報告による大量保有報告書から、5% を超えて保有する機関投資家を返します。列名は yfinance に合わせています。

戻り値 — pandas.DataFrame

列	型	説明
`Date Reported`	`datetime64`	基準日
`Holder`	`str`	保有者名
`pctHeld`	`float`	保有割合（小数）
`Shares`	`int`	保有株式数
`pctChange`	`float`	前回の報告との差
`holderEdinetCode`	`str`	保有者の EDINET コード
`sourceDocumentId`	`str`	EDINET の書類管理番号
`Value`	—	yfinance との互換性を保つために設けた列で、常に空。評価額の算出には株価が必要

Ticker.large_holders -> pandas.DataFrame
Ticker.get_large_holders(as_dict=False) -> pandas.DataFrame | dict

大量保有報告書を提出したすべての保有者について、保有者ごとに最新の報告を 1 行で返します。事業会社と個人も含みます。

戻り値 — pandas.DataFrame

Ticker.large_holder_transactions -> pandas.DataFrame
Ticker.get_large_holder_transactions(as_dict=False) -> pandas.DataFrame | dict

大量保有報告書の「最近 60 日間の取得又は処分の状況」から、直近 100 件を返します。同一の売買は 1 行にまとめます。

戻り値 — pandas.DataFrame

Ticker.large_holder_activity -> pandas.DataFrame
Ticker.get_large_holder_activity(as_dict=False) -> pandas.DataFrame | dict

上記の売買を、データ上の最新の提出日から遡った 6 か月間を対象に集計します。普通株式と投資証券に限ります。表の形式は yfinance の insider_purchases と同じで、7 行と Shares・Trans の列を持ちます。

Ticker.large_holding_reports -> pandas.DataFrame
Ticker.get_large_holding_reports(limit=100, offset=0) -> pandas.DataFrame

その銘柄について提出された大量保有報告書を、新しい順に返します。共同保有者は 1 行ずつ返します。 limit と offset で取得する範囲を指定できます。総件数は .attrs["total"] で確認できます。

引数

名前	型	既定値	説明
`limit`	`int`	`100`	返す行数
`offset`	`int`	`0`	読み飛ばす行数

戻り値 — pandas.DataFrame

列	型	説明
`Date Filed`、`Base Date`	`datetime64`	提出日と基準日
`Title`	`str`	書類の表題
`Holder`、`Holder Type`、`Is Joint`	`str`, `str`, `bool`	保有者、その区分、共同保有者かどうか
`pctHeld`、`Previous pctHeld`	`float`	今回と前回の保有割合
`Shares`、`Total Outstanding`	`float`	保有株式数と発行済株式総数
`Purpose`、`Important Proposal`、`Reason`	`str`	保有目的、重要提案行為等の有無、提出事由
`Holder EDINET Code`、`Document ID`	`str`	EDINET のコード