Institutional ownership
Query institutional stock positions and quarterly aggregates.
Available data
- Returns
- Institutional positions or quarterly aggregates
- Market coverage
- Institutional positions: US stocks. Quarterly totals: US and HK stocks.
- What each request returns
- View positions by institution or quarterly totals; the latest period is returned when no date is selected.
Authentication
Query Parameters
Provide at least one of asset_id or query. query also requires market
asset_idstringqueryconditionalAsset identifier for stocks, crypto assets and other asset objects
querystringqueryconditionalStock or ETF ticker/name; market is required when using query
Required with query; optional with asset_id
marketstringqueryconditionalRequired with query; optional when asset_id identifies the subject. Institutional positions: US stocks. Quarterly totals: US and HK stocks
Positions support US stocks; quarterly totals support US and HK stocks. Selecting HK switches the view to quarterly totals
asset_classstringqueryoptionalAsset class for disambiguation; cannot override the endpoint subject type
viewstringqueryoptionalholders (default) for institutional rows; summary for quarterly aggregates
periodstringqueryoptionalsummary only: YYYY/Q1–YYYY/Q4; omit for the latest available quarter
holder_namestringqueryoptionalholders only: filter by institution name
fromdatequeryoptionalInclusive start date: reporting date for institutional rows, trade date for other lists
todatequeryoptionalInclusive end date; must not precede from
pageintegerqueryoptionalPage number, starting at 1; defaults to 1
page_sizeintegerqueryoptionalDefaults to 50, maximum 100; explicitly set 20 if preferred
Response
request_idstringExample3f80785d-e708-4aa9-b8a6-a266c2351fedRequest trace ID
Object resolution status
Data status
Business data
viewstringExampleholdersReturned view: holders or summary
Reporting period range on this page
fromdateExample2026-09-30Earliest reporting date on this page
todateExample2026-09-30Latest reporting date on this page
period_countintegerExample1Reporting periods on this page
Business records
holder_namestringExample10Elms LlpInstitution name
as_of_datedateExample2026-09-30Reporting date; a single batch for fund holdings
shares_heldnumberExample1078Current shares held
shares_changenumber | nullExample-54Share change versus the same holder’s previous available quarter
shares_change_pctnumber | nullExample-4.770318Quarterly share change (%)
change_base_datedate | nullExample2026-06-30Baseline date for share changes
market_valuenumber | nullExample384Position value, in the unit specified by market_value_unit
market_value_unitstringExampleUSD_THOUSANDValue unit; USD_THOUSAND means thousands of USD
period_keystringQuarter key (summary)
period_end_datedateQuarter-end date (summary)
institutional_holding_pctnumberInstitutional ownership ratio, 0–1 (summary)
institutional_holding_quantitynumberTotal institutional shares (summary)
institution_countintegerInstitution count (summary)
institutional_holding_pct_changenumberOwnership ratio change in decimal form (summary)
institutional_holding_quantity_changenumberQuarterly total share change (summary)
institution_count_changeintegerQuarterly institution count change (summary)
change_base_period_keystringBaseline quarter (summary)
periodstringReturned quarter, YYYY/Qn
Pagination, freshness and limitations
GateData object references
Object type
idstringExampleasset_aapl_common_stockObject ID
Pagination
pageintegerExample1Current page
page_sizeintegerExample2Page size
totalintegerExample5542Total matching records
Source tracking array
ref_idstringExamplesrc_4ab0eaf5f1fadcac5a94a2b39563d414Source tracking ID
observed_atdatetimeData observation time
updated_atdatetimeExample2026-11-16T05:50:29.000+0000Data update time (UTC)
limitations[]string[]Additional information
errorobject | nullError object; null on success