GateData.AI

Institutional ownershipComing soon

Query institutional and ETF holdings.

This data domain is coming soon. Documentation is available now for reading and integration planning. REST and MCP try-it are disabled until this domain launches — paths and parameters will not change at GA.
GET/api/v1/ownership/institutional
Domain
Flows & Wallets
Level
Public-company entity
MCP tool
ownership_flows_query (task=institutional)

Available data

Returns
Institutional and ETF holdings
Market coverage
US equities
Query granularity
One company per query, listed by reporting period; periods are not merged

Authentication

Send Authorization: Bearer YOUR_API_KEY or X-API-KEY on every request.

Query Parameters

asset_idstringqueryExampleasset_btcrequired

Catalog asset ID (e.g. asset_btc) or symbol (e.g. BTC).

limitintegerqueryExample20optional

Max rows to return (up to 1000).

Response

metadataobject
data_statusDataStatusExamplenot_ready

not_ready — endpoint responds 200 but payload is not populated yet

limitations[]string[]Exampledata_not_ready

Includes data_not_ready

object_refs[]object[]

Unified object references

Errors & fallback

200
assets_resolve name multi-match; confirm from data[] candidates.
200
The object resolved but no data is available; empty_reason may be not_covered_by_source, unsupported_metric, or limited_depth.
400
Invalid parameters or an ambiguous market listing; ambiguity responses include required_params + candidates.
401
The API key is missing or invalid.
403
The current key scope or plan cannot access this data domain.
404
The requested resource does not exist; source coverage gaps are not 404 responses.
402
Credits or monthly quota exhausted.
429
Request rate exceeded; retry_after is returned in the body and Retry-After in the response headers.