ETF / Fund Holdings
Query ETF holdings, weights and batch summary.
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
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. US ETFs
Enter an ETF symbol to query holdings for a selected date or the latest reporting batch
asset_classstringqueryoptionalAsset class for disambiguation; cannot override the endpoint subject type
as_of_datedatequeryoptionalHoldings date; omit for the latest batch, without mixing reporting dates
top_nintegerqueryoptionalTop N holdings, maximum 100; takes precedence over pagination
include_cashbooleanqueryoptionalCash and money-market position option; defaults to true
pageintegerqueryoptionalPage number, starting at 1; defaults to 1
page_sizeintegerqueryoptionalDefaults to 50, maximum 100; explicitly set 20 if preferred
Response
request_idstringExamplereq_exampleRequest trace ID
Object resolution status
Data status
Business data
Subject ETF
asset_idstringExampleasset_spy_etfGateData asset ID
symbolstringExampleSPYETF symbol
namestringExampleSPDR S&P 500 ETF TRUSTETF name
as_of_datedateExample2026-10-27Reporting date; a single batch for fund holdings
Business records
rankintegerExample1Rank by holding weight
holding_symbolstring | nullExampleNVDAHolding symbol
holding_namestringExampleNVIDIA CorporationHolding or position name
weight_pctnumber | nullExample7.92Portfolio weight (%)
sharesnumber | nullExample295426533Holding quantity
Summary metrics for the reporting batch
top10_pctnumber | nullExample38.09Batch top-ten weight (%)
total_holdingsinteger | nullExample505Total holdings in the reporting batch
Pagination, freshness and limitations
GateData object references
Object type
idstringExampleasset_aapl_common_stockObject ID
Pagination
pageintegerExample1Current page
page_sizeintegerExample20Page size
totalintegerExample1Total matching records
Source tracking array
ref_idstringExamplesrc_opaqueSource tracking ID
observed_atdatetimeExample2026-10-30T05:00:00ZData observation time
updated_atdatetimeExample2026-10-30T05:00:00ZData update time (UTC)
limitations[]string[]Examplecoverage_limitationAdditional information
errorobject | nullError object; null on success