Docs/Reference/Ownership/List Cross Holdings
GET/v1/ownership/cross-holdingsTier · Institutional

List Cross Holdings

All detected cross-shareholding pairs (持ち合い株 / 政策保有株), market-wide.

Returns every reciprocal stake between listed Japanese companies, including the sub-threshold pairs that form most of Japanese keiretsu structure. Sorted by combined holding ratio so the largest mutual stakes appear first; pairs with NULL ratios sink to the end.

'relationship_type' distinguishes source + confidence, see the field's description. Use this as the inventory of cross- holdings that exist; pair it with /ownership/unwinding-scoreboard to see which of those are actively declining.

Query parameters · 3

Optional filters and modifiers. Pass as URL-encoded ?key=value.

limitintegeroptional

Results per page

default 50
offsetintegeroptional

Results to skip (ignored when cursor is set)

default 0
cursorstring | nulloptional

Opaque cursor for keyset pagination

Request headers · 1

Authentication.

Authorizationstringrequired

Production API key. Pass it as Bearer ax_live_…

Returns · 200

The standard { data, meta } envelope. data contains an array of CrossHoldingOut.

Envelope

dataCrossHoldingOut[]

Array of result objects.

metaMeta

Pagination and request metadata, including request_id, data_as_of, and ontology_version.

ontology_version 2.1.0replay meta.as_of · ?as_of=<token>

CrossHoldingOut

company_a_edinet_codestring

EDINET code of company A

company_a_securities_codestring | null

Securities code of company A

company_a_namestring | null

Name of company A

company_b_edinet_codestring

EDINET code of company B

company_b_securities_codestring | null

Securities code of company B

company_b_namestring | null

Name of company B

a_holds_b_pctnumber | null

A's holding ratio in B (%). May be NULL when the underlying disclosure type doesn't carry a ratio (see relationship_type).

b_holds_a_pctnumber | null

B's holding ratio in A (%). Same NULL semantics as a_holds_b_pct.

min_pctnumber | null

The smaller of the two reciprocal holdings (%). NULL when either side's ratio is NULL.

sectorstring | null

Shared or representative sector for the pair (company A's sector when both share it; A's sector otherwise). Null when sector is unknown.

relationship_typestring

Pair classification. One of: 'mutual_attested' (both sides confirm holding each other), 'single_side_attested' (one side confirms), 'mutual_self_join' (both directions observed without explicit confirmation), 'mutual' (legacy high-threshold pair, only these rows carry holding ratios).

cluster_idinteger | null

Cluster grouping ID

Errors

Standard HTTP status codes plus a typed error.code in the { error: { code, message } } envelope.

Every endpoint returns the same typed error envelope ({ error: { code, message } }). For the full list of codes, see the Errors reference.