Cross-Shareholdings (EDINET)(/edinet/cross-shareholdings)
GET /v2/edinet/cross-shareholdings
Overview
Retrieves, per scope (the reporting company itself, the consolidated group company with the largest holdings, and the second-largest holdings) disclosed in Section 4 "Status of Shares" of the Annual Securities Report (Form No.3), the listed / non-listed share counts and their changes, the specified investment / deemed holding records, and footnote text.
Attention
- Available from March 31, 2020 onward. Target document is the Annual Securities Report.
- Available on the Standard plan or higher (Free / Light plans cannot use this API). Historical range: Standard up to 10 years, Premium up to 20 years.
- Cross-shareholdings data is available via API only. File download (CSV / Bulk) is not supported.
- The data provided by this API is refined using an LLM.
- We do not provide the date and time when each data item became available on J-Quants. For update frequency and approximate update times, see Update Timing of Provided Data.
- Questions we have received about data specifications are also answered in the FAQ (Data & Specs).
Data correction policy
- In this service, we may add or overwrite data due to data deficiencies or omissions. In such cases, the correction history is recorded on Data Correction History and Known issues, so please refer to it.
Note: In these cases, neither the correction history nor pre-correction data is provided via the API, CSV, or other means.
Retrieve the cross-shareholdings status
GET https://api.jquants.com/v2/edinet/cross-shareholdings
edinet_code / code / date are all optional.
The parameter combinations and response are as follows.
| edinet_code/code | date | Results |
|---|---|---|
| All reports submitted today | ||
| Reports for the specified EDINET code / issue code (within the plan's historical range) | ||
| All reports submitted on the specified date | ||
| The report for the specified EDINET code / issue code submitted on the specified date |
※ Specifying both edinet_code and code at the same time returns an error (400).
※ If no matching data exists, an empty array ("data": []) is returned.
Requests
Headers
- x-api-keystringrequired
API key
Query Parameters
- edinet_codestringoptional
EDINET code (e.g. E02367)
- codestringoptional
Issue code (e.g. 79740 or 7974)
- datestringoptional
Submission date (e.g. 20250620 or 2025-06-20)
- pagination_keystringoptional
Pagination key string
Specify the value returned by the previous call'spagination_key.
Sample request code
Request
curl -G https://api.jquants.com/v2/edinet/cross-shareholdings \
-H "x-api-key: {loading}" \
-d edinet_code="E03814"Responses
Response fields
Document metadata (one object per filing)
- DocIdstring
- EDINET document management number (
S+ 7 alphanumeric characters) - Codestring
- Issue code of the filer (5 digits)
- EdinetCodestring
- EDINET code of the filer
- FilerNamestring
- Filer name (Japanese)
- FilerNameEnstring
- Filer name (English)
- DocTypeCodestring
- Document type code (
120= Annual Securities Report) - SubDatestring
- Submission date (YYYY-MM-DD)
- SubTimestring
- Submission time (HH:MM:SS)
- PerStstring
- Start date of the target fiscal year (YYYY-MM-DD)
- PerEnstring
- End date of the target fiscal year (YYYY-MM-DD)
- Reportobject
- Holdings block for the reporting company itself.
- Largestobject
- Holdings block for the consolidated group company with the largest holdings.
- SecondLargestobject
- Holdings block for the consolidated group company with the second-largest holdings.
Holder block (shared by Report / Largest / SecondLargest)
- HldrNamestring
- Name of this holder
- HldrCodestring
- Issue code of this holder (5 digits)
- HldrEdinetCodestring
- EDINET code of this holder
- ListedIssnumber
- Listed: number of issues
- ListedBookValnumber
- Listed: total carrying amount (JPY)
- ListedIncIssnumber
- Listed: number of issues whose share count increased
- ListedIncAcqCostnumber
- Listed: total acquisition cost for the increased shares (JPY)
- ListedDecIssnumber
- Listed: number of issues whose share count decreased
- ListedDecSaleAmtnumber
- Listed: total sale amount for the decreased shares (JPY)
- ListedIncRsnstring
- Listed: reason for the increase in shares
- NonListedIssnumber
- Non-listed: number of issues
- NonListedBookValnumber
- Non-listed: total carrying amount (JPY)
- NonListedIncIssnumber
- Non-listed: number of issues whose share count increased
- NonListedIncAcqCostnumber
- Non-listed: total acquisition cost for the increased shares (JPY)
- NonListedDecIssnumber
- Non-listed: number of issues whose share count decreased
- NonListedDecSaleAmtnumber
- Non-listed: total sale amount for the decreased shares (JPY)
- NonListedIncRsnstring
- Non-listed: reason for the increase in shares
- Specarray
- Array of specified investment holding records
- Deemarray
- Array of deemed holding records
- SpecFnstring
- Footnote for specified investment holdings
- DeemFnstring
- Footnote for deemed holdings
Issue record (element of Spec[] / Deem[])
- IsrNamestring
- Name of the held entity
- IsrCodestring
- Issue code of the held entity (5 digits, resolved by name from
IsrName) - IsrEdinetCodestring
- EDINET code of the held entity (resolved by name from
IsrName) - CurShsnumber
- Number of shares in the current fiscal year
- PriShsnumber
- Number of shares in the prior fiscal year
- CurBookValnumber
- Carrying amount in the current fiscal year (JPY)
- PriBookValnumber
- Carrying amount in the prior fiscal year (JPY)
- CurShsNotDiscstring
- Raw non-disclosure marker for the current-year share count (
*/*/※/(注 N)) - PriShsNotDiscstring
- Raw non-disclosure marker for the prior-year share count
- CurBookValNotDiscstring
- Raw non-disclosure marker for the current-year carrying amount
- PriBookValNotDiscstring
- Raw non-disclosure marker for the prior-year carrying amount
- HoldRatstring
- Purpose / business alliance / quantitative effect / reason for increase (combined text)
- IsrHoldsstring
- Raw indicator of whether the issuer holds the reporting company's shares (e.g.,
"有"/"無"/"無(注)3") - IsrHoldsCodestring
- Normalized 3-value form (
"1"= holds,"0"= does not hold,"2"= undetermined)
Response sample
{
"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",
"Report": {
"HldrName": "株式会社日本取引所グループ",
"HldrCode": "86970",
"HldrEdinetCode": "E03814",
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 6,
"NonListedBookVal": 1035000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [
{
"IsrName": "Sample Bank, Ltd.",
"IsrCode": "56780",
"IsrEdinetCode": "E05678",
"CurShs": 1200000,
"PriShs": 1200000,
"CurBookVal": 850000000,
"PriBookVal": 820000000,
"CurShsNotDisc": null,
"PriShsNotDisc": null,
"CurBookValNotDisc": null,
"PriBookValNotDisc": null,
"HoldRat": "To maintain and strengthen business relationships",
"IsrHolds": "有",
"IsrHoldsCode": "1"
}
],
"Deem": [
{
"IsrName": "Sample Electric Co., Ltd.",
"IsrCode": "90120",
"IsrEdinetCode": "E09012",
"CurShs": 500000,
"PriShs": null,
"CurBookVal": 350000000,
"PriBookVal": null,
"CurShsNotDisc": null,
"PriShsNotDisc": "(注3)",
"CurBookValNotDisc": null,
"PriBookValNotDisc": "(注3)",
"HoldRat": "Because the reporter holds voting-direction authority",
"IsrHolds": "無(注)3",
"IsrHoldsCode": "0"
}
],
"SpecFn": "<p>Note: Specified investment shares are held to maintain and strengthen business relationships.</p>",
"DeemFn": "<p>(Note 3) These shares are effectively held through a retirement benefit trust, and the reporter retains voting-direction authority under the trust agreement. Prior-period share counts and book values are not disclosed due to a change in the trust contract.</p>"
},
"Largest": null,
"SecondLargest": {
"HldrName": "株式会社東京証券取引所",
"HldrCode": null,
"HldrEdinetCode": null,
"ListedIss": 0,
"ListedBookVal": 0,
"ListedIncIss": 0,
"ListedIncAcqCost": 0,
"ListedDecIss": 0,
"ListedDecSaleAmt": 0,
"ListedIncRsn": null,
"NonListedIss": 2,
"NonListedBookVal": 953000000,
"NonListedIncIss": 0,
"NonListedIncAcqCost": 0,
"NonListedDecIss": 0,
"NonListedDecSaleAmt": 0,
"NonListedIncRsn": null,
"Spec": [],
"Deem": [],
"SpecFn": null,
"DeemFn": null
}
}
],
"pagination_key": "value1.value2."
}