holdings

Get the holdings for an individual ETF.

Parameters

• standard
• fmp
• intrinio
• tmx

symbol: str
Symbol to get data for. (ETF)

symbol: str
Symbol to get data for. (ETF)

symbol: str
Symbol to get data for. (ETF)

date: date | None | str
A specific date to get data for.

symbol: str
Symbol to get data for. (ETF)

use_cache: bool | None
Default: True
Whether to use a cached request. All ETF data comes from a single JSON file that is updated daily. To bypass, set to False. If True, the data will be cached for 4 hours.

---

Returns

results: EtfHoldings

Serializable results.

provider: Optional[Literal['fmp', 'intrinio', 'tmx']]

Provider name.

warnings: Optional[list[Warning_]]

list of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• fmp
• intrinio
• tmx

symbol: str | None
Symbol representing the entity requested in the data.

name: str | None
Name of the asset.

symbol: str | None
Symbol representing the entity requested in the data.

name: str | None
Name of the asset.

cusip: str | None
The CUSIP of the holding.

isin: str | None
The ISIN of the holding.

weight: float | None
The weight of the holding, as a normalized percent.

shares: float | str | None
The number of shares held.

value: float | None
The market value of the holding.

updated: date | datetime | None
The date the data was updated.

symbol: str | None
Symbol representing the entity requested in the data.

name: str | None
The common name for the holding.

security_type: str | None
The type of instrument for this holding. Examples(Bond='BOND', Equity='EQUI')

isin: str | None
The International Securities Identification Number.

ric: str | None
The Reuters Instrument Code.

sedol: str | None
The Stock Exchange Daily Official list.

share_class_figi: str | None
The OpenFIGI symbol for the holding.

country: str | None
The country or region of the holding.

maturity_date: date | None
The maturity date for the debt security, if available.

contract_expiry_date: date | None
Expiry date for the futures contract held, if available.

coupon: float | None
The coupon rate of the debt security, if available.

balance: int | float | None
The number of units of the security held, if available.

unit: str | None
The units of the 'balance' field.

units_per_share: float | None
Number of units of the security held per share outstanding of the ETF, if available.

face_value: float | None
The face value of the debt security, if available.

derivatives_value: float | None
The notional value of derivatives contracts held.

value: float | None
The market value of the holding, on the 'as_of' date.

weight: float | None
The weight of the holding, as a normalized percent.

updated: date | None
The 'as_of' date for the holding.

symbol: str | None
The ticker symbol of the asset.

name: str | None
The name of the asset.

weight: float | None
The weight of the asset in the portfolio, as a normalized percentage.

shares: int | str | None
The value of the assets under management.

market_value: float | str | None
The market value of the holding.

currency: str | None
The currency of the holding.

share_percentage: float | None
The share percentage of the holding, as a normalized percentage.

share_change: float | str | None
The change in shares of the holding.

country: str | None
The country of the holding.

exchange: str | None
The exchange code of the holding.

type_id: str | None
The holding type ID of the asset.

fund_id: str | None
The fund ID of the asset.