Ownership — Large-holdings events

Disclosure events fired when a holder crosses the 5% ownership threshold or moves by ±1% afterward.

GET /v1/ownership/{ticker}/large-holdings-events basic+ JP

Parameters

Name	Type	Req	Description
ticker	path	yes	Ticker symbol.

Example

curl -H "X-API-Key: rk_YOUR_KEY" \
  https://api.rockmoon.ai/v1/ownership/7203/large-holdings-events

r = requests.get(
    "https://api.rockmoon.ai/v1/ownership/7203/large-holdings-events",
    headers={"X-API-Key": "rk_YOUR_KEY"},
)
for e in r.json()["events"]:
    print(e["filing_date"], e["filer_name_en"],
          e["holding_ratio"], e["holding_ratio_delta"])

const r = await fetch(
  "https://api.rockmoon.ai/v1/ownership/7203/large-holdings-events",
  { headers: { "X-API-Key": "rk_YOUR_KEY" } },
);
const { events } = await r.json();

Response 200

{
  "ticker": "7203",
  "count": 6,
  "events": [
    {
      "doc_id": "S100VWDH",
      "filing_date": "2025-06-01",
      "amendment_flag": "0.0",
      "filer_edinet_code": "E01514",
      "filer_name_en": "TOYOTA INDUSTRIES CORPORATION",
      "filer_member": "FilerLargeVolumeHolder1Member",
      "filer_kind": null,
      "shares_held": 1192330920.0,
      "shares_outstanding": 15794987460.0,
      "holding_ratio": 0.0755,
      "holding_ratio_prev": 0.0703,
      "holding_ratio_delta": 0.0052,
      "funding_own": 253209063000.0,
      "funding_borrowings": null,
      "funding_total": 253209063000.0,
      "purpose_of_holding": null,
      "base_date": null,
      "doc_type_code": null
    }
  ]
}

Errors

HTTP	Code	Cause
403	`upgrade_required`	Basic+ required.
404	`ticker_not_found`	Unknown ticker.
429	`rate_limit_exceeded`	Rate limit hit. Honor `Retry-After`.

Notes

Event semantics: the initial filing fires when a holder first crosses 5%; amendments fire on subsequent ±1% moves. Use holding_ratio_delta to tell directional moves from index-fund noise.
Custodian noise: trust banks filing on behalf of index funds generate a steady stream of small-delta events — filter by filer_name_en if you want only directional accumulators.
Empty events is normal for tickers no large holder has crossed recently.