Get fund holdings
See the positions in a disclosed ETF or mutual fund portfolio, with weights, quantities and reported values where available.
How it works
-
Choose the portfolio. Use a fund identifier. Share classes can resolve to a shared portfolio. The response identifies the portfolio whose positions were disclosed. Use
get_profilefor identity andget_listingsfor trading venues. -
Choose the snapshot.
as_ofselects the latest eligible portfolio date on or before the cutoff.known_byuses the filing date when available and the date the disclosure version was first recorded otherwise. Publication dates are blank when unavailable. Omit both filters for the latest available snapshot. -
Read weights as percentages. A weight of
7.5means 7.5% of the portfolio. Weights are reported or calculated from position values and net assets where available. Quantities use the accompanying unit when known. Net assets and position values carry their own currencies. Positions can have negative weights, and a security can appear on multiple rows. Synthetic ETFs may disclose an investment basket that differs from their benchmark exposure. -
Page through positions. Position rows are ordered by descending weight, with unknown weights last. Pass
next_cursorascursorwith the same filters until it is null. If a new disclosure or correction changes the snapshot, start again from the first page. -
Trace a snapshot. Request
include_sources=truefor available filing, regulator, or fund manager links. The source link may refer to an archive or a newer version. Use the response'sas_offor the date of the holdings returned here. -
Check coverage. Coverage varies by fund, market and date. Some disclosures cover only the main investments. Canadian iShares fund-of-funds snapshots show the positions held directly by the fund. Canadian mutual fund portfolios use fund-level LEIs and the main investment schedule from annual or interim issuer financial statements. A null
fundmeans no unique portfolio matched the request.
Request
GET /api/v1/fund-holdings with your API key. AI assistants call it as the get_fund_holdings tool, with the same parameters.
Parameters
qstringrequired
Fund identifier.
More parameters
include_sourcesboolean
Include available source documents and supporting evidence. Omit for data only.
Default: false
as_ofdate
Latest eligible portfolio date, inclusive.
YYYY-MM-DD
known_bydate
Latest eligible filing date or first recorded date, inclusive.
YYYY-MM-DD
limitinteger
Maximum number of positions.
Default: 20 · From 1 to 100
cursorstring
Continuation from next_cursor. Omit for the first page.
Response
JSON with these fields. A field the source doesn't report is null or left out.
queryRequested identifier
next_cursorSnapshot continuation cursor, or null on the last page
fundobjectrequired
Show child attributes
nameReported fund or portfolio name
identifierobject
Show child attributes
typeType of portfolio identifier
valueIdentifier of the reported portfolio
as_ofPortfolio date, when known
publication_dateDisclosure publication date, when known
total_holdingsTotal number of position rows in the snapshot
net_assetsobject
Show child attributes
amountReported portfolio net assets in currency units
currencyCurrency of net assets, when known
has_withheld_positionsWhether the Brazilian disclosure includes confidential aggregate positions
source_noticeobject
Show child attributes
sourceData provider
noticeRequired attribution and reuse notice
source_urlPublic source catalogue
terms_urlReuse terms
sourcesarray of objects
Show child attributes
kindSource type
urlLink to the disclosure or source archive
holdingsarray of objectsrequired
Show child attributes
nameReported position name
security_titleReported security title
isinReported or exchange-verified ISIN
cusipReported CUSIP
isin_sourceobject
Show child attributes
urlExchange or issuer reference used to verify an ISIN absent from the holdings file
publishedReference publication date, when known
sha256Fingerprint of the reference version
asset_classAsset class of the position, with other for uncategorized positions
weight_percentPortfolio weight in percent
quantityReported position quantity
quantity_unitshares, units, principal_amount, contracts or null
instrument_currencyReported currency of the instrument, when known
market_valueobject
Show child attributes
amountReported position value, when its denomination is established
currencyCurrency in which the position value is denominated
matchIdentifier lookup outcome. A found match can still have an empty page.
Errors
| Status | Meaning |
|---|---|
| 400 | Missing, unknown or invalid parameter, or an identifier that can't be looked up |
| 401 | Missing, unknown or revoked API key |
| 402 | No active plan or trial, or the included request allowance is used |
| 403 | API access of the account is suspended |
| 404 | The identifier matches nothing or is ambiguous. The match field identifies the outcome |
| 429 | Over the plan's rate limit; Retry-After says when to retry |
| 500 | Internal error; the same request is unlikely to succeed on retry |
| 503 | The data couldn't be loaded right now; Retry-After says when to retry, when known |
Errors are JSON with an error message saying what to fix. Errors are free. See Errors and limits.