Skip to content

Find funds holding a security

Find fund portfolios that reported holding a specific security and see their matching positions.

How it works

  • Choose the security. An ISIN identifies a specific security. An exchange-qualified ticker works when it resolves to a single ISIN.
  • Choose the report dates. Each fund uses its latest eligible disclosure before matching positions. as_of limits the portfolio date. known_by limits the filing date or, for issuer snapshots, the date the snapshot was collected. Both cutoffs are inclusive. The selected report date can differ by fund.
  • Read the matching positions. A weight of 7.5 means 7.5% of that fund's portfolio. Separate positions are returned as separate rows. An isin_source identifies the reference used to link a position when its disclosure supplied an exchange-qualified symbol. Use get_fund_holdings to see the full portfolio and its disclosure source.
  • Page through funds. Results are ordered by fund name, then portfolio identifier. Pass next_offset as offset with the same filters until it is null.
  • Check coverage. This lookup searches the same sources as the full portfolio endpoint. An empty funds list can mean the identifier did not resolve to a single ISIN or that no eligible disclosure matched. Empty results do not count toward your request allowance.

Request

GET /api/v1/funds/holding with your API key. AI assistants call it as the get_funds_holding_security tool, with the same parameters.

Parameters

qstringrequired

Held security identifier, such as an ISIN or an exchange-qualified ticker (AAPL:XNAS).

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 or collection date, inclusive.

YYYY-MM-DD

limitinteger

Maximum number of fund portfolios.

Default: 20 · From 1 to 100

offsetinteger

Fund portfolios to skip.

Default: 0 · From 0 to 9007199254740991

Response

JSON with these fields. A field the source doesn't report is null or left out.

query

Requested security identifier

next_offsetrequired

Offset of the next page, or null on the last page

fundsarray of objectsrequired
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

net_assetsobject
Show child attributes
amount

Reported portfolio net assets in currency units

currency

Currency of net assets, when known

positionsarray 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

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

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