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/AAPL/institutionalr = requests.get(
"https://api.rockmoon.ai/v1/ownership/AAPL/institutional",
headers={"X-API-Key": "rk_YOUR_KEY"},
)
for h in r.json()["holdings"][:5]:
print(h["period_end_date"], h["holder_name"], h["position_qty"], h["position_value_usd"])const r = await fetch(
"https://api.rockmoon.ai/v1/ownership/AAPL/institutional",
{ headers: { "X-API-Key": "rk_YOUR_KEY" } },
);
const { holdings } = await r.json();Response 200
{
"ticker": "AAPL",
"cusip": "037833100",
"count": 100,
"holdings": [
{
"id": 66011345,
"accession": "0000102909-26-000031",
"filed_on_date": "2026-01-29",
"period_end_date": "2025-12-31",
"ingested_at": "2026-04-14 03:35:46",
"holder_cik": "0000102909",
"holder_name": "VANGUARD GROUP INC",
"cusip": "037833100",
"src_issuer_name": "APPLE INC",
"symbol": null,
"figi": "",
"instrument_kind": "stock",
"share_class_label": "COM",
"src_title_of_class": "COM",
"src_putcall": null,
"src_sshprnamttype": "SH",
"position_qty": 1279051701.0,
"position_qty_unit": "shares",
"position_value_usd": 347722995434.0,
"unit_cost_usd": 271.86,
"discretion_level": "sole",
"voting_sole_qty": 0.0,
"voting_shared_qty": 0.0,
"voting_none_qty": 1279051701.0,
"provenance": "form13f_dera:01dec2025-28feb2026_form13f"
}
]
}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
- Quarterly + lagged: the regulatory window closes 45 days after quarter end, so the freshest row is always at least that stale.
- Long-only: short positions are not reported.
- Confidential treatment filings (where managers temporarily withhold positions) are not included until released.
- Coverage: tickers with a CUSIP map entry. Others return an empty
holdingsarray.