Etfs

Get an ETF profile with exact-ticker settled market performance, split-safe range coverage, SEC-reported assets and concentration, asset and country allocation, and the ten largest stored portfolio holdings. Fields unavailable from the current SEC holdings dataset are omitted rather than inferred.

get/v1/etfs/{ticker}

Request

Path parameters

tickerstring required

Exact exchange-traded ticker (for example SPY, VOO, or IVV), or MIC:TICKER for a fund listed on another exchange (for example XETR:SXR8), whose figures are in its trading currency.

Response

OK

tickerstring nullable

The exchange-traded ticker, normalized to dash-listed form; MIC:TICKER for a fund listed outside the US.

namestring nullable

SEC series name, or the listing's own registered security name when the ticker is that listing's own primary ticker; null when neither is stated.

sponsorstring nullable

Registrant that files the series; null when no series is linked.

structurestring nullable

Registration form the series files under, in plain words.

exchangestring nullable

The ISO 10383 market identifier code of a fund listed outside the US; absent for a US listing.

currencystring nullable

ISO 4217 currency a fund listed outside the US trades and is priced in, in major units; absent for a US listing, which is in US dollars.

isinstring nullable

ISIN of a fund listed outside the US; absent for a US listing.

secSeriesIdstring nullable

SEC series identifier; empty when the filing states none.

pricenumber double nullable

Latest settled close for the exact listed ticker.

priceDatestring date nullable

Session the settled close belongs to.

priceIsIntradayboolean

Always false on this endpoint; use the quote endpoint for plan-entitled intraday data.

dayChangePercentnumber double nullable

Percentage change against the prior settled close, to four decimals.

netAssetsnumber double nullable

Net assets in US dollars from the latest report.

totalAssetsnumber double nullable

Total assets in US dollars from the latest report.

holdingCountinteger nullable

Holding rows stored for the latest report.

reportedHoldingCountinteger nullable

Investment-row count the filing itself reports, before the storage filter.

holdingsCoveragestring nullable

One of "fullPortfolio", "trackedEquitiesOnly", or "unknown".

reportPeriodDatestring date nullable

Date the reported portfolio is as of.

high52Weeknumber double nullable

Highest settled close over the covered range.

low52Weeknumber double nullable

Lowest settled close over the covered range.

range52WeekStartDatestring date nullable

First comparable date of the range, which a split can shorten.

range52WeekIsPartialboolean

True when a split prevented a full trailing-year comparison.

averageVolume30Dayinteger nullable

Mean daily volume over the comparable sessions counted below.

averageVolumeSessionCountinteger

Number of settled sessions the average volume covers.

topTenWeightPercentnumber double nullable

Combined weight of the ten largest positions; null unless coverage is complete.

priceHistoryStartDatestring date nullable

First session of the bounded five-year series behind the chart.

coverageNotestring nullable

States each figure's source and what is deliberately not inferred.

Changes

No recorded changes to this operation across all 1 revision of this API.