Skip to content

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_profile for identity and get_listings for trading venues.
  • Choose the snapshot. as_of selects the latest eligible portfolio date on or before the cutoff. known_by uses 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.5 means 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_cursor as cursor with 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=true for available filing, regulator, or fund manager links. The source link may refer to an archive or a newer version. Use the response's as_of for 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 fund means 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.

query

Requested identifier

next_cursor

Snapshot continuation cursor, or null on the last page

fundobjectrequired
Show child attributes
name

Reported fund or portfolio name

identifierobject
Show child attributes
type

Type of portfolio identifier

value

Identifier of the reported portfolio

as_of

Portfolio date, when known

publication_date

Disclosure publication date, when known

total_holdings

Total number of position rows in the snapshot

net_assetsobject
Show child attributes
amount

Reported portfolio net assets in currency units

currency

Currency of net assets, when known

has_withheld_positions

Whether the Brazilian disclosure includes confidential aggregate positions

source_noticeobject
Show child attributes
source

Data provider

notice

Required attribution and reuse notice

source_url

Public source catalogue

terms_url

Reuse terms

sourcesarray of objects
Show child attributes
kind

Source type

url

Link to the disclosure or source archive

holdingsarray of objectsrequired
Show child attributes
name

Reported position name

security_title

Reported security title

isin

Reported or exchange-verified ISIN

cusip

Reported CUSIP

isin_sourceobject
Show child attributes
url

Exchange or issuer reference used to verify an ISIN absent from the holdings file

published

Reference publication date, when known

sha256

Fingerprint of the reference version

asset_class

Asset class of the position, with other for uncategorized positions

weight_percent

Portfolio weight in percent

quantity

Reported position quantity

quantity_unit

shares, units, principal_amount, contracts or null

instrument_currency

Reported currency of the instrument, when known

market_valueobject
Show child attributes
amount

Reported position value, when its denomination is established

currency

Currency in which the position value is denominated

match

Identifier 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.

Esc

Documentation

Make your first request API keys and authentication Errors and limits Connect an AI assistant (MCP) Usage and billing Contact support Get company profile Get securities and listings Get reported earnings Get financial statements Get historical financial metrics Get financial segments Get historical shares outstanding Get fund holdings Find funds holding a security Screen companies Get screener filters
↑↓ to move to open