--- title: "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." method: GET path: "/v1/etfs/{ticker}" tags: ["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 - Base URL: `https://api.equibles.com` - URL: `https://api.equibles.com/v1/etfs/{ticker}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) ## Path parameters - `ticker` string, required ## Response `200` OK - EtfProfileResponse: Dedicated ETF profile: exact-ticker settled market figures alongside SEC fund facts from the latest NPORT-P report. Concentration and allocation are returned only when stored and reported holding counts prove the portfolio is complete; expense ratio and benchmark are never inferred. - `ticker` string, nullable: The exchange-traded ticker, normalized to dash-listed form; MIC:TICKER for a fund listed outside the US. - `name` string, 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. - `sponsor` string, nullable: Registrant that files the series; null when no series is linked. - `structure` string, nullable: Registration form the series files under, in plain words. - `exchange` string, nullable: The ISO 10383 market identifier code of a fund listed outside the US; absent for a US listing. - `currency` string, 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. - `isin` string, nullable: ISIN of a fund listed outside the US; absent for a US listing. - `secSeriesId` string, nullable: SEC series identifier; empty when the filing states none. - `price` number, double, nullable: Latest settled close for the exact listed ticker. - `priceDate` string, date, nullable: Session the settled close belongs to. - `priceIsIntraday` boolean: Always false on this endpoint; use the quote endpoint for plan-entitled intraday data. - `dayChangePercent` number, double, nullable: Percentage change against the prior settled close, to four decimals. - `netAssets` number, double, nullable: Net assets in US dollars from the latest report. - `totalAssets` number, double, nullable: Total assets in US dollars from the latest report. - `holdingCount` integer, nullable: Holding rows stored for the latest report. - `reportedHoldingCount` integer, nullable: Investment-row count the filing itself reports, before the storage filter. - `holdingsCoverage` string, nullable: One of "fullPortfolio", "trackedEquitiesOnly", or "unknown". - `reportPeriodDate` string, date, nullable: Date the reported portfolio is as of. - `high52Week` number, double, nullable: Highest settled close over the covered range. - `low52Week` number, double, nullable: Lowest settled close over the covered range. - `range52WeekStartDate` string, date, nullable: First comparable date of the range, which a split can shorten. - `range52WeekIsPartial` boolean: True when a split prevented a full trailing-year comparison. - `averageVolume30Day` integer, nullable: Mean daily volume over the comparable sessions counted below. - `averageVolumeSessionCount` integer: Number of settled sessions the average volume covers. - `topTenWeightPercent` number, double, nullable: Combined weight of the ten largest positions; null unless coverage is complete. - `priceHistoryStartDate` string, date, nullable: First session of the bounded five-year series behind the chart. - `performance` EtfPerformanceDto: Split-adjusted total-return windows computed from settled daily bars for the exact listed ticker. - `oneWeekPercent` number, double, nullable: Total return over the trailing week; null when the window lacks settled bars. - `oneMonthPercent` number, double, nullable: Total return over the trailing month; null when the window lacks settled bars. - `sixMonthPercent` number, double, nullable: Total return over the trailing six months; null when the window lacks settled bars. - `monthToDatePercent` number, double, nullable: Total return since the start of the current month; null when unavailable. - `yearToDatePercent` number, double, nullable: Total return since the start of the current year; null when unavailable. - `assetAllocations` EtfAllocationDto[], nullable: Asset-category breakdown; empty unless coverage is complete. - `label` string, nullable: The SEC asset-category or country code the group is filed under. - `percent` number, double: Share of the reported portfolio, as a percentage of net assets. - `countryAllocations` EtfAllocationDto[], nullable: Country breakdown; empty unless coverage is complete. - `label` string, nullable: The SEC asset-category or country code the group is filed under. - `percent` number, double: Share of the reported portfolio, as a percentage of net assets. - `topHoldings` EtfHoldingDto[], nullable: Ten largest stored positions, largest first. - `name` string, nullable: Holding name exactly as the source states it. - `ticker` string, nullable: For a US fund, the ticker resolved from the holding CUSIP against tracked stocks; for a fund on another exchange, the platform symbol of the listing the holding's ISIN (or stated US ticker) names, such as AAPL or XETR:SAP. Null when nothing we hold matches. - `cusip` string, nullable: CUSIP as filed in an NPORT-P report; null where the filing states none, and for a fund on another exchange. Always present, as it was before those funds shared this row. - `isin` string, nullable: ISIN as the sponsor's file states it; absent for a US fund and where the file states none. - `balance` number, double, nullable: Quantity held, in the unit stated by units; absent where the source states none. - `units` string, nullable: The unit balance is expressed in, as filed (for example NS for number of shares); absent where unstated. - `valueUsd` number, double, nullable: Position value in US dollars, as filed in an NPORT-P report; absent for a fund on another exchange. - `percentOfNetAssets` number, double, nullable: Position value as a percentage of the fund's net assets, as filed in an NPORT-P report. - `weightPercent` number, double, nullable: Weight of the position in the fund, in percent, as the sponsor's file states it; absent for a US fund. - `marketValue` number, double, nullable: Position value in the stated currency, as the sponsor's file states it; absent where unstated. - `currency` string, nullable: ISO 4217 currency of marketValue and of the holding's line; absent where unstated. - `assetCategory` string, nullable: Asset category as the source states it (SEC code such as EC for a US fund; the sponsor's own class, such as Equity or Futures, for a fund on another exchange). - `sector` string, nullable: Sector as the sponsor's file states it; absent for a US fund. - `exchange` string, nullable: Exchange name as the sponsor's file states it; absent for a US fund. - `country` string, nullable: Investment country: the SEC code as filed for a US fund, the sponsor's own country name otherwise. - `coverageNote` string, nullable: States each figure's source and what is deliberately not inferred. ## Other responses - `400`: Bad Request - `404`: Not Found --- [API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)