Returns the constituent securities held by an ETF on a single date, with weights, market values and share counts.
| Name | Description | Example |
|---|---|---|
|
identifier
|
An ETF identifier (Ticker, ISIN, CUSIP, FIGI, Intrinio ID) | SPY |
|
date
|
Return the holdings snapshot for this date. If no snapshot exists on the date, the closest one on or before it is returned. Defaults to the latest available. | - |
|
page_size
|
The number of results to return | - |
|
next_page
|
Gets the next page of data from a previous API call | - |
|
identifier
* required
An ETF identifier (Ticker, ISIN, CUSIP, FIGI, Intrinio ID)
|
||
|
date
* required
Return the holdings snapshot for this date. If no snapshot exists on the date, the closest one on or before it is returned. Defaults to the latest available.
|
||
|
page_size
* required
The number of results to return
|
||
|
next_page
* required
Gets the next page of data from a previous API call
|
| Name | Description | Type |
|---|---|---|
| messages | Notices about the request, including warnings for unknown query parameters that were ignored. Always present; empty when there is nothing to report. | array |
|
type
|
string | |
| holdings_count | The total number of holdings the ETF reported on this date, across all pages | integer |
| etf | object | |
|
id
|
The Intrinio ID for the ETF | string |
|
ticker
|
The common/local ticker of the ETF | string |
|
name
|
The common name of the ETF | string |
|
issuer
|
The issuer of the ETF | string |
|
date
|
The vendor file date on which this profile became effective | date |
|
asset_class
|
The broad asset class the ETF invests in | string |
|
category
|
The ETF Global category within the asset class | string |
|
focus
|
The ETF Global investment focus within the category | string |
|
listing_exchange
|
The exchange on which the ETF is listed | string |
| holdings | array | |
|
date
|
The vendor file date the holdings snapshot belongs to | date |
|
as_of_date
|
The date the underlying data is effective as of, which may lag the file date | date |
|
ticker
|
The ticker of the constituent security | string |
|
name
|
The name of the constituent security | string |
|
weight
|
The fraction of the fund held in this security (0.0776 means 7.76%) | number |
|
market_value
|
The market value of the position | number |
|
shares_held
|
The number of shares held | number |
|
cusip
|
The CUSIP of the constituent security | string |
|
isin
|
The ISIN of the constituent security | string |
|
figi
|
The FIGI of the constituent security | string |
|
country_of_exchange
|
The country of the exchange the constituent trades on | string |
|
exchange
|
The exchange the constituent trades on | string |
|
asset_class
|
The asset class of the constituent security | string |
|
security_type
|
The security type of the constituent, such as Common Stock or ETP | string |
|
currency_traded
|
The currency the constituent trades in | string |
|
security
|
The Intrinio security matched to this holding, if one could be matched | object |
|
id
|
The Intrinio ID for Security | string |
|
company_id
|
The Intrinio ID for the Company for which the Security is issued | string |
|
exchange
|
The exchange's MIC | string |
|
exchange_mic
|
The security's exchange MIC | string |
|
stock_exchange_id
|
The exchange's Intrinio ID | string |
|
name
|
The name of the Security | string |
|
code
|
A 2-3 digit code classifying the Security (reference) | string |
|
currency
|
The currency in which the Security is traded on the exchange | string |
|
ticker
|
The common/local ticker of the Security | string |
|
composite_ticker
|
The country-composite ticker of the Security | string |
|
figi
|
The OpenFIGI identifier | string |
|
composite_figi
|
The country-composite OpenFIGI identifier | string |
|
share_class_figi
|
The global-composite OpenFIGI identifier | string |
|
primary_listing
|
If true, the Security is the primary issue for the company, otherwise it is a secondary issue on a secondary stock exchange | boolean |
| next_page | The token required to request the next page of the data | string |
|
messages
Notices about the request, including warnings for unknown query parameters that were ignored. Always present; empty when there is nothing to report.
|
||
|
holdings_count
The total number of holdings the ETF reported on this date, across all pages
|
||
|
etf
|
||
|
holdings
|
||
|
next_page
The token required to request the next page of the data
|