# 大株主状況（EDINET）(/edinet/major-shareholders)

`GET`    /v2/edinet/major-shareholders

## APIの概要

有価証券報告書に記載されている大株主の状況を取得することができます。

### 本APIの留意点

> **Info**
>
> - データ提供期間は2016年6月1日以降、対象書類は有価証券報告書 第三号様式です。
> - Standard プラン以上で利用可能です（Free / Light プランでは本 API を利用できません）。過去データの参照範囲はプランに応じて Standard=10年前まで、Premium=20年前までです。
> - 大株主の情報は通常上位10名ですが、同順位タイで11位以降の株主が記載されている書類では11件以上となります。100%子会社等で1名のみのケースもあり、件数は固定ではありません。
> - 大株主状況は API 経由でのみご利用いただけます。ファイルダウンロード（CSV／Bulk）には対応しておりません。

## 大株主データを取得します

`GET` `https://api.jquants.com/v2/edinet/major-shareholders`

データの取得では、`edinet_code` / `code` / `date` を任意で指定できます。\
各パラメータの組み合わせとレスポンスの結果については以下のとおりです。

- edinet\_code/code: –, date: – → API実行日に提出された全有報のデータ一覧

- edinet\_code/code: ✓, date: – → 指定された EDINETコード / 銘柄コードのデータ一覧（プラン参照範囲内）

- edinet\_code/code: –, date: ✓ → 指定日に提出された全有報のデータ一覧

- edinet\_code/code: ✓, date: ✓ → 指定された EDINETコード / 銘柄コードの、指定日提出有報のデータ

※ `edinet_code` と `code` の同時指定は不可です（400 エラー）。\
※ 該当データが存在しない場合は空配列（`"data": []`）を返却します。

### Requests

### Headers

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| x-api-key | string | Required | APIキー       |

### Query Parameters

| Parameter       | Type   | Required | Description                                   |
| --------------- | ------ | -------- | --------------------------------------------- |
| edinet\_code    | string | Optional | EDINETコード（e.g. E03814）                        |
| code            | string | Optional | 銘柄コード（e.g. 86970 or 8697）                     |
| date            | string | Optional | 提出日（e.g. 20250620 or 2025-06-20）              |
| pagination\_key | string | Optional | 検索の先頭を指定する文字列 過去の検索で返却された pagination\_key を設定 |

### APIコールサンプルコード

/v2/edinet/major-shareholders

**cURL**

```bash
curl -G https://api.jquants.com/v2/edinet/major-shareholders \
-H "x-api-key: {{apiKey}}" \
-d edinet_code="{{edinet_code}}"
```

**JavaScript**

```javascript
import axios from 'axios'

const client = axios.create({
baseURL: 'https://api.jquants.com',
headers: { 'x-api-key': '{{apiKey}}' },
})

await client.get('/v2/edinet/major-shareholders', {
params: {
  edinet_code: '{{edinet_code}}',
},
})
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
  "https://api.jquants.com/v2/edinet/major-shareholders",
  params={"edinet_code": "{{edinet_code}}"},
  headers=headers,
)
print(resp.json())
```

### Responses

### データ項目概要

#### 書類メタ（書類ごとに1オブジェクト）

| Parameter   | Type   | Required | Description                |
| ----------- | ------ | -------- | -------------------------- |
| DocId       | string | Required | EDINET 書類管理番号（`S` + 7桁英数字） |
| Code        | string | Required | 提出会社の銘柄コード（5桁）             |
| EdinetCode  | string | Required | 提出会社の EDINET コード           |
| FilerName   | string | Required | 提出者名（会社名）                  |
| FilerNameEn | string | Required | 提出者名（英語）                   |
| DocTypeCode | string | Required | 書類種別コード（`120` = 有価証券報告書）   |
| SubDate     | string | Required | 提出日（YYYY-MM-DD）            |
| SubTime     | string | Required | 提出時刻（HH:MM:SS）             |
| PerSt       | string | Required | 対象事業年度の開始日（YYYY-MM-DD）     |
| PerEn       | string | Required | 対象事業年度の終了日（YYYY-MM-DD）     |
| Hldrs       | array  | Required | 大株主レコード配列（順位順、Rank 昇順）     |

#### Hldrs 配列要素

| Parameter | Type    | Required | Description                                  |
| --------- | ------- | -------- | -------------------------------------------- |
| Rank      | integer | Required | 順位（1〜10、タイで11以降あり）                           |
| HldrName  | string  | Required | 株主氏名又は名称                                     |
| HldrAddr  | string  | Required | 株主住所                                         |
| ShsHeld   | number  | Required | 所有株式数（株）                                     |
| ShsRatio  | number  | Required | 発行済株式（自己株式を除く）に対する所有割合。小数表現（0.1881 = 18.81%） |

### レスポンスサンプル

```bash {{ title: "200:OK" }}
{
    "data": [
        {
            "DocId": "S100YA84",
            "Code": "86970",
            "EdinetCode": "E03814",
            "FilerName": "株式会社日本取引所グループ",
            "FilerNameEn": "Japan Exchange Group, Inc.",
            "DocTypeCode": "120",
            "SubDate": "2026-06-11",
            "SubTime": "15:00:00",
            "PerSt": "2025-04-01",
            "PerEn": "2026-03-31",
            "Hldrs": [
                {
                    "Rank": 1,
                    "HldrName": "日本マスタートラスト信託銀行株式会社（信託口）",
                    "HldrAddr": "東京都港区赤坂１丁目８番１号　赤坂インターシティＡＩＲ",
                    "ShsHeld": 175830000,
                    "ShsRatio": 0.1704
                },
                {
                    "Rank": 2,
                    "HldrName": "株式会社日本カストディ銀行（信託口）",
                    "HldrAddr": "東京都中央区晴海１丁目８－１２",
                    "ShsHeld": 56970000,
                    "ShsRatio": 0.0552
                },
                {
                    "Rank": 3,
                    "HldrName": "ＳＴＡＴＥ　ＳＴＲＥＥＴ　ＢＡＮＫ　ＡＮＤ　ＴＲＵＳＴ　ＣＯＭＰＡＮＹ　５０５００１（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＯＮＥ　ＣＯＮＧＲＥＳＳ　ＳＴＲＥＥＴ，　ＳＵＩＴＥ　１，　ＢＯＳＴＯＮ，　ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 26685000,
                    "ShsRatio": 0.0259
                },
                {
                    "Rank": 4,
                    "HldrName": "ＳＴＡＴＥ　ＳＴＲＥＥＴ　ＢＡＮＫ　ＡＮＤ　ＴＲＵＳＴ　ＣＯＭＰＡＮＹ　　５０５３０１（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＯＮＥ　ＣＯＮＧＲＥＳＳ　ＳＴＲＥＥＴ，　ＳＵＩＴＥ　１，　ＢＯＳＴＯＮ，　ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 17838000,
                    "ShsRatio": 0.0173
                },
                {
                    "Rank": 5,
                    "HldrName": "ＪＰモルガン証券株式会社",
                    "HldrAddr": "東京都千代田区丸の内２丁目７－３　東京ビルディング",
                    "ShsHeld": 15316000,
                    "ShsRatio": 0.0148
                },
                {
                    "Rank": 6,
                    "HldrName": "ＪＰ　ＭＯＲＧＡＮ　ＣＨＡＳＥ　ＢＡＮＫ　３８５７８１（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "２５　ＢＡＮＫ　ＳＴＲＥＥＴ，　ＣＡＮＡＲＹ　ＷＨＡＲＦ，　ＬＯＮＤＯＮ，　Ｅ１４　５ＪＰ，　　ＵＮＩＴＥＤ　ＫＩＮＧＤＯＭ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 15139000,
                    "ShsRatio": 0.0147
                },
                {
                    "Rank": 7,
                    "HldrName": "株式会社三菱ＵＦＪ銀行",
                    "HldrAddr": "東京都千代田区丸の内１丁目４番５号",
                    "ShsHeld": 15114000,
                    "ShsRatio": 0.0146
                },
                {
                    "Rank": 8,
                    "HldrName": "ＳＴＡＴＥ　ＳＴＲＥＥＴ　ＢＡＮＫ　ＡＮＤ　ＴＲＵＳＴ　ＣＯＭＰＡＮＹ　５０５１０３（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＯＮＥ　ＣＯＮＧＲＥＳＳ　ＳＴＲＥＥＴ，　ＳＵＩＴＥ　１，　ＢＯＳＴＯＮ，　ＭＡＳＳＡＣＨＵＳＥＴＴＳ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 14996000,
                    "ShsRatio": 0.0145
                },
                {
                    "Rank": 9,
                    "HldrName": "ＨＳＢＣ　ＨＯＮＧ　ＫＯＮＧ－ＴＲＥＡＳＵＲＹ　ＳＥＲＶＩＣＥＳ　Ａ／Ｃ　ＡＳＩＡＮ　ＥＱＵＩＴＩＥＳ　ＤＥＲＩＶＡＴＩＶＥＳ（常任代理人　香港上海銀行東京支店）",
                    "HldrAddr": "１　ＱＵＥＥＮ’Ｓ　ＲＯＡＤ　ＣＥＮＴＲＡＬ，ＨＯＮＧ　ＫＯＮＧ（東京都中央区日本橋３丁目１１－１）",
                    "ShsHeld": 14484000,
                    "ShsRatio": 0.014
                },
                {
                    "Rank": 10,
                    "HldrName": "Ｊ．Ｐ．　ＭＯＲＧＡＮ　ＢＡＮＫ　ＬＵＸＥＭＢＯＵＲＧ　Ｓ．Ａ．　３８４５１３（常任代理人　株式会社みずほ銀行決済営業部）",
                    "HldrAddr": "ＥＵＲＯＰＥＡＮ　ＢＡＮＫ　ＡＮＤ　ＢＵＳＩＮＥＳＳ　ＣＥＮＴＥＲ　６，　ＲＯＵＴＥ　ＤＥ　　ＴＲＥＶＥＳ，　Ｌ－２６３３　ＳＥＮＮＩＮＧＥＲＢＥＲＧ，　ＬＵＸＥＭＢＯＵＲＧ（東京都港区港南２丁目１５－１　品川インターシティＡ棟）",
                    "ShsHeld": 14035000,
                    "ShsRatio": 0.0136
                }
            ]
        }
    ],
    "pagination_key": "value1.value2."
}
```