---
title: "保有比率の時系列"
method: GET
path: "/shareholders/history"
tags: ["Shareholders"]
---

# 保有比率の時系列

`GET /shareholders/history`

## Request

- Base URL: `https://edinetdb.jp/v1`
- URL: `https://edinetdb.jp/v1/shareholders/history`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

filer × issuer の保有比率の変遷を返す。アクティビストのポジション推移、
保有者サイドのポートフォリオ履歴分析に使用。

filer / issuer / group は AND 条件（自由に併用可・最低1つ必須）。issuer と group を併用すると、その発行会社における当該グループの保有履歴のみを返す（発行会社の全株主ではない）。group は parent_group_id と同義。

## Query parameters

- `filer` string
- `issuer` string
- `group` string

## Response `200`

保有履歴リスト（issuer → base_date の昇順）。同一 base_date の複数行は別 filer の並行提出であり、訂正報告の重複ではない

- object
  - `data` object[]
    - `base_date` string, date: 報告義務発生日（基準日）
    - `doc_id` string: EDINET 書類管理番号
    - `est_acquisition_price` number, nullable: 推定取得単価 = funding_total ÷ shares_held（円）。est_acquisition_price_flag が potential_shares / dealer_inventory / implausible_high の行は信頼できないため null（2026-08-19 変更）。far_below_market は値を保持。
    - `est_acquisition_price_flag` 'ok' | 'no_reference' | 'far_below_market' | 'potential_shares_minor' | 'potential_shares_corroborated' | 'potential_shares' | 'dealer_inventory' | 'implausible_high', nullable: 推定取得単価の信頼性判定。potential_shares = 潜在株券等（新株予約権証券等）が保有株券等の数の 50% 超、または 10% 超で有報期末株価と整合しない（分母が株式取得数でない）/ dealer_inventory = 証券会社の商品在庫 / implausible_high = 有報期末株価に比べて異常に高い値（×1000 単位誤記が主）→ いずれも est を null 化。 far_below_market = 有報期末株価の 1/100 未満（創業者原価等の正しい低原価か、 千円単位誤記か区別不能。値は保持、funding_total と併せて判断）/ potential_shares_corroborated = 潜在株券等 10–50% だが有報期末株価の 0.1〜10 倍に収まる（値は保持）/ potential_shares_minor = 潜在株券等が 10% 以下（値は保持、推定誤差小）/ no_reference = 参照株価なし / ok。funding_total が無い行は null。
    - `est_holding_value` number, nullable
    - `filer_edinet_code` string
    - `filer_name` string
    - `funding_other` integer, nullable: その他金額計（借株・匿名組合出資等。提出者記載値そのまま、円）
    - `funding_total` integer, nullable: 取得資金合計（提出者記載値そのまま、円）。様式上は千円欄のため、提出者が 千円値/×1000 で記載した書類が混在する（補正しない）。
    - `holding_ratio` number: 保有割合。小数表記（0.1291 = 12.91%）
    - `holding_ratio_change` number, nullable
    - `holding_ratio_previous` number, nullable
    - `is_change_report` boolean: 変更報告書なら true（初回報告は false）
    - `issuer_edinet_code` string
    - `issuer_name` string
    - `issuer_sec_code` string
    - `parent_group_id` string, nullable: 関連法人の統合ID。グループ未定義の filer は null
    - `purpose_category` string: activist / activist_implied / pure_investment / strategic / institutional / dealer / other / undisclosed. 'undisclosed' means the filing's purpose field was empty (no purpose disclosed); 'other' means a purpose was disclosed but didn't match a known pattern.
    - `recent_acq_price_wavg` number, nullable: 単価が記載された取得行の数量加重平均単価（円/株）。約定単価・新株予約権の行使価格ベースの 実績値で、est_acquisition_price（取得資金÷保有数）とは別定義。単価未記載の行と、 1個当たり単価で記載される新株予約権証券の行は含まない
    - `recent_acq_priced_qty` integer, nullable: recent_acq_price_wavg の分母（単価付き取得数量）
    - `recent_acq_qty` integer, nullable: 同表の取得数量合計（株数ベース、提出者記載値）。数量が「個」・単価が「1個当たり」で 記載される新株予約権証券そのものの行は、単位系が異なるため除外する（明細では取得可能）
    - `recent_disp_price_wavg` number, nullable: 単価が記載された処分行の数量加重平均単価（円/株。新株予約権証券の行は含まない）
    - `recent_disp_priced_qty` integer, nullable
    - `recent_disp_qty` integer, nullable: 同表の処分数量合計（株数ベース。新株予約権証券の行は除外、recent_acq_qty と同基準）
    - `recent_txn_count` integer, nullable: 当該報告書の「最近60日間の取得又は処分の状況」表の取引行数（parse_status=ok のみ、 新株予約権証券の行を含む）。集計対象は当該行の提出者（代表 holder）で、共同保有者側の みが表を持つ報告書（実測 3,859/38,205 書類）は null。表が無い/取引なしも null。 明細（共同保有者分を含む全行）は /v1/shareholders/transactions（2026-08-19 追加）
    - `recent_txn_from` string, date, nullable
    - `recent_txn_to` string, date, nullable
    - `shares_held` integer: 保有株式数。変更報告での減少は負値
    - `shares_potential` integer, nullable: 保有潜在株券等の数（新株予約権証券等、提出者記載値）。shares_held に含まれる。 原本で「－」/未記載は null。flag 判定では null を 0 とみなすが、未捕捉（GCS 欠損 2 件等）の可能性もあるため一次データとして確認すること
    - `submit_date_time` string, date-time: EDINET が書類を受理した日時。RFC 3339 の UTC（末尾 +00:00）で返す。 EDINET の原表記は JST（分単位）なので、JST で見る場合は +9 時間する。 ⚠️ 2026-07-29 の是正より前は JST の時刻値に UTC のラベルを付けて返していた（9 時間ずれ）。 当時の値を 9 時間補正して使っていた場合は、その補正を外すこと。 適用時刻は /docs/data-quality の変更履歴に記載。
  - `meta` object: filer / issuer / group の echo と total_results（フィルタ適用後の件数）

## Other responses

- `400`: filer/issuer/group のいずれも指定なし

---

[API](https://skmtc.dev/edinetdb/apis/edinet-db-api.md) · [All operations](https://skmtc.dev/edinetdb/apis/edinet-db-api/llms.txt) · [OpenAPI document](https://skmtc.dev/edinetdb/apis/edinet-db-api/revisions/d896c5f7d472?raw)