ETF / Fund Holdings

Query ETF holdings, weights and batch summary.

GET/api/v1/funds/holdings
Domain
Flows & Wallets
Level
Asset identification
MCP tool
ownership_flows_query (task=fund_holdings)

Available data

Returns
ETF holdings, weights and batch summary
Market coverage
US ETFs
What each request returns
View an ETF’s holdings for a reporting date; the latest batch is returned when no date is selected.

Authentication

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

Query Parameters

Asset identification

Provide at least one of asset_id or query. query also requires market

asset_idstringqueryconditional

Asset identifier for stocks, crypto assets and other asset objects

querystringqueryconditional

Stock or ETF ticker/name; market is required when using query

Market

Required with query; optional with asset_id

marketstringqueryconditional

Required with query; optional when asset_id identifies the subject. US ETFs

Filters and pagination

Enter an ETF symbol to query holdings for a selected date or the latest reporting batch

asset_classstringqueryoptional

Asset class for disambiguation; cannot override the endpoint subject type

as_of_datedatequeryoptional

Holdings date; omit for the latest batch, without mixing reporting dates

top_nintegerqueryoptional

Top N holdings, maximum 100; takes precedence over pagination

include_cashbooleanqueryoptional

Cash and money-market position option; defaults to true

pageintegerqueryoptional

Page number, starting at 1; defaults to 1

page_sizeintegerqueryoptional

Defaults to 50, maximum 100; explicitly set 20 if preferred

Response

request_idstringExamplereq_example

Request trace ID

resolution_statusResolutionStatusExampleresolved

Object resolution status

data_statusDataStatusExamplepartial

Data status

dataobject

Business data

fundobject

Subject ETF

asset_idstringExampleasset_spy_etf

GateData asset ID

symbolstringExampleSPY

ETF symbol

namestringExampleSPDR S&P 500 ETF TRUST

ETF name

as_of_datedateExample2026-10-27

Reporting date; a single batch for fund holdings

items[]object[]

Business records

rankintegerExample1

Rank by holding weight

holding_symbolstring | nullExampleNVDA

Holding symbol

holding_namestringExampleNVIDIA Corporation

Holding or position name

weight_pctnumber | nullExample7.92

Portfolio weight (%)

sharesnumber | nullExample295426533

Holding quantity

summaryobject

Summary metrics for the reporting batch

top10_pctnumber | nullExample38.09

Batch top-ten weight (%)

total_holdingsinteger | nullExample505

Total holdings in the reporting batch

metadataobject

Pagination, freshness and limitations

object_refs[]object[]

GateData object references

typeObjectRefTypeExampleasset

Object type

idstringExampleasset_aapl_common_stock

Object ID

paginationobject

Pagination

pageintegerExample1

Current page

page_sizeintegerExample20

Page size

totalintegerExample1

Total matching records

source_refs[]object[]

Source tracking array

ref_idstringExamplesrc_opaque

Source tracking ID

observed_atdatetimeExample2026-10-30T05:00:00Z

Data observation time

updated_atdatetimeExample2026-10-30T05:00:00Z

Data update time (UTC)

limitations[]string[]Examplecoverage_limitation

Additional information

errorobject | null

Error object; null on success

Errors & fallback

200
The request was processed and query results are returned.
400
Missing identity, conflicting parameters, invalid enum/date/range or quarter (YYYY/Qn).
404
Object not found or ambiguous; refine identity.
422
Market or asset type not supported.
503
The requested data is temporarily unavailable.
502
Upstream error without usable cached data.