# 大量保有報告書（EDINET）(/edinet/large-volume-shareholders)

`GET`    /v2/edinet/large-volume-shareholders

## APIの概要

大量保有報告書・変更報告書に記載されている発行者、提出者情報を取得することができます。

### 本APIの留意点

> **Info**
>
> - データ提供期間は提出日2021年7月1日以降、対象書類は大量保有報告書・変更報告書等（書類種別コード350）です。
> - Standard プラン以上で利用可能です（Free / Light プランでは本 API を利用できません）。過去データの参照範囲はプランに応じて Standard=10年前まで、Premium=20年前までです。
> - 大量保有報告書は API 経由でのみご利用いただけます。ファイルダウンロード（CSV／Bulk）には対応しておりません。

## 大量保有データを取得します

`GET` `https://api.jquants.com/v2/edinet/large-volume-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/large-volume-shareholders

**cURL**

```bash
curl -G https://api.jquants.com/v2/edinet/large-volume-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/large-volume-shareholders', {
params: {
  edinet_code: '{{edinet_code}}',
},
})
```

**Python**

```python
import requests

headers = {"x-api-key": "{{apiKey}}"}
resp = requests.get(
  "https://api.jquants.com/v2/edinet/large-volume-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コード                                                                                                |
| IsrName           | string | Required | 発行者名                                                                                                          |
| DocTypeCode       | string | Required | 書類種別コード（`350` = 大量保有報告書関連）                                                                                    |
| SubDate           | string | Required | 提出日（YYYY-MM-DD）                                                                                               |
| SubTime           | string | Required | 提出時刻（HH:MM:SS）                                                                                                |
| LargeHldgTypeCode | string | Required | 大量保有書類種別コード（`1`=大量保有報告書 / `2`=変更報告書 / `3`=変更報告書（短期大量譲渡） / `4`=大量保有報告書（特例対象株券等） / `5`=変更報告書（特例対象株券等） / `0`=不明） |
| DocTitle          | string | Required | 書類表題（e.g. 大量保有報告書）                                                                                            |
| ChgRsn            | string | Required | 報告義務発生日における変更事由（変更報告書のみ）                                                                                      |
| TotalShsHeld      | number | Required | 保有株券等の数の合計（株）                                                                                                 |
| TotalShsRatio     | number | Required | 株券等保有割合の合計。小数表現（0.1343 = 13.43%）                                                                              |
| TotalShsRatioLast | number | Required | 直前の報告書に係る株券等保有割合の合計（変更報告書のみ）                                                                                  |
| TotalOutStks      | number | Required | 発行済株式等総数（株）                                                                                                   |
| Hldrs             | array  | Required | 提出者及び共同保有者のレコード配列                                                                                             |

#### Hldrs 配列要素

| Parameter         | Type   | Required | Description                        |
| ----------------- | ------ | -------- | ---------------------------------- |
| HldrName          | string | Required | 保有者の氏名又は名称                         |
| HldrNameEn        | string | Required | 保有者の名称（英語）                         |
| HldrEdinetCode    | string | Required | 保有者の EDINETコード                     |
| HldrCode          | string | Required | 保有者の銘柄コード（保有者が上場会社の場合等）            |
| LargeHldrTypeCode | string | Required | 保有者区分コード（`1`=個人 / `2`=法人 / `0`=不明） |
| LargeHldrTypeRaw  | string | Required | 保有者区分（個人法人の別）の書類記載生値               |
| HldgPurp          | string | Required | 保有目的                               |
| ImpProp           | string | Required | 重要提案行為等                            |
| ColAgr            | string | Required | 担保契約等重要な契約                         |
| ShsHeld           | number | Required | 保有株券等の数（株）                         |
| ShsRatio          | number | Required | 株券等保有割合。小数表現（0.0572 = 5.72%）       |
| ShsRatioLast      | number | Required | 直前の報告書に係る株券等保有割合（変更報告書のみ）          |
| OwnFund           | number | Required | 取得資金のうち自己資金額（円）                    |
| TotalBrw          | number | Required | 取得資金のうち借入金額計（円）                    |
| TotalOther        | number | Required | 取得資金のうちその他金額計（円）                   |
| OtherBrk          | string | Required | その他金額計の内訳（株式分割による取得等、記載がある場合）      |
| TotalFund         | number | Required | 取得資金合計（円）                          |
| AcqDisp           | array  | Required | 最近60日間の取得又は処分の状況の配列                |
| BrwList           | array  | Required | 借入金の内訳の配列                          |
| CredList          | array  | Required | 借入先の名称等の配列                         |

#### AcqDisp 配列要素（最近60日間の取得又は処分の状況）

| Parameter   | Type   | Required | Description                  |
| ----------- | ------ | -------- | ---------------------------- |
| Date        | string | Required | 年月日（YYYY-MM-DD）              |
| SecType     | string | Required | 株券等の種類（e.g. 普通株式）            |
| Shs         | number | Required | 数量（株）                        |
| Ratio       | number | Required | 割合（%）                        |
| Mkt         | string | Required | 市場内外取引の別（書類記載の生値）            |
| MktCode     | string | Required | 市場内外取引コード（`1`=市場内 / `2`=市場外） |
| TxnType     | string | Required | 取得又は処分の別（書類記載の生値）            |
| TxnTypeCode | string | Required | 取得又は処分コード（`1`=取得 / `2`=処分）   |
| Cptty       | string | Required | 譲渡の相手方（短期大量譲渡変更の書類でのみ記載）     |
| Price       | number | Required | 単価（円）                        |
| PriceRaw    | string | Required | 単価の生値                        |

#### BrwList 配列要素（借入金の内訳）

| Parameter   | Type   | Required | Description                                    |
| ----------- | ------ | -------- | ---------------------------------------------- |
| Name        | string | Required | 名称（支店名を含む）                                     |
| Ind         | string | Required | 業種                                             |
| Rep         | string | Required | 代表者氏名                                          |
| Addr        | string | Required | 所在地                                            |
| DiscBrwPurp | string | Required | 借入目的の開示区分（`1`=銀行等に開示せず / `2`=銀行等に開示及び銀行等以外の借入） |
| Amt         | number | Required | 金額（円）                                          |

#### CredList 配列要素（借入先の名称等）

| Parameter | Type   | Required | Description |
| --------- | ------ | -------- | ----------- |
| Name      | string | Required | 名称（支店名を含む）  |
| Rep       | string | Required | 代表者氏名       |
| Addr      | string | Required | 所在地         |

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

```bash {{ title: "200:OK" }}
{
    "data": [
        {
            "DocId": "S100WBIV",
            "Code": "86970",
            "EdinetCode": "E03814",
            "IsrName": "株式会社日本取引所グループ",
            "DocTypeCode": "350",
            "SubDate": "2025-07-07",
            "SubTime": "12:09:00",
            "LargeHldgTypeCode": "5",
            "DocTitle": "変更報告書ＮＯ．9",
            "ChgRsn": "・株券等保有割合の１％以上の増加",
            "TotalShsHeld": 76018630,
            "TotalShsRatio": 0.0728,
            "TotalShsRatioLast": 0.0614,
            "TotalOutStks": 1044578366,
            "Hldrs": [
                {
                    "HldrName": "サンプル・アセットマネジメント株式会社",
                    "HldrNameEn": "Sample Asset Management Co., Ltd.",
                    "HldrEdinetCode": "E99990",
                    "HldrCode": null,
                    "LargeHldrTypeCode": "2",
                    "LargeHldrTypeRaw": "法人(株式会社)",
                    "HldgPurp": "信託財産の運用として保有している。",
                    "ImpProp": null,
                    "ColAgr": null,
                    "ShsHeld": 59555500,
                    "ShsRatio": 0.057,
                    "ShsRatioLast": 0.0506,
                    "OwnFund": null,
                    "TotalBrw": null,
                    "TotalOther": null,
                    "OtherBrk": null,
                    "TotalFund": null,
                    "AcqDisp": [],
                    "BrwList": [],
                    "CredList": []
                },
                {
                    "HldrName": "サンプル証券株式会社",
                    "HldrNameEn": "Sample Securities Co., Ltd.",
                    "HldrEdinetCode": "E99991",
                    "HldrCode": null,
                    "LargeHldrTypeCode": "2",
                    "LargeHldrTypeRaw": "法人(株式会社)",
                    "HldgPurp": "証券業務に係る商品在庫として保有している。",
                    "ImpProp": null,
                    "ColAgr": "消費貸借契約により、サンプル信託銀行株式会社から1,000,000株 借入れている。（本項目はサンプルです）",
                    "ShsHeld": 8893542,
                    "ShsRatio": 0.0085,
                    "ShsRatioLast": 0.0095,
                    "OwnFund": 300000000,
                    "TotalBrw": 500000000,
                    "TotalOther": null,
                    "OtherBrk": null,
                    "TotalFund": 800000000,
                    "AcqDisp": [
                        {
                            "Date": "2025-06-20",
                            "SecType": "普通株式",
                            "Shs": 100000,
                            "Ratio": 0.01,
                            "Mkt": "市場内",
                            "MktCode": "1",
                            "TxnType": "取得",
                            "TxnTypeCode": "1",
                            "Cptty": null,
                            "Price": 3800,
                            "PriceRaw": null
                        }
                    ],
                    "BrwList": [
                        {
                            "Name": "サンプル銀行株式会社",
                            "Ind": "銀行",
                            "Rep": "代表取締役 見本 太郎",
                            "Addr": "東京都千代田区丸の内一丁目1番1号",
                            "DiscBrwPurp": "2",
                            "Amt": 500000000
                        }
                    ],
                    "CredList": [
                        {
                            "Name": "サンプル信託銀行株式会社",
                            "Rep": "代表取締役 例示 花子",
                            "Addr": "東京都千代田区大手町一丁目1番1号"
                        }
                    ]
                }
            ]
        }
    ],
    "pagination_key": "value1.value2."
}
```