Use /v1/stocks/{ticker}/… for shared stock and ETF trading data. The ticker identifies the exact listing, not every product belonging to its SEC registrant: VOO and VB can share a registrant but must never share market data or institutional positions. ETF-specific profiles and portfolio holdings remain under /v1/etfs.
| What you need | Resource |
|---|---|
| Prices, quotes, options, reported short data, settlement data, owners | /v1/stocks/{ticker}/… |
| ETF profile and investments inside its portfolio | /v1/etfs |
| Broader registered-fund series and operations | /v1/funds |
| Registrant filings and text search | /v1/filings |
| Congressional trades | /v1/congress/trades?ticker=… |
| Operating-company financials and issuer-derived forecasts | Existing company-focused /v1/stocks/{ticker}/… routes |
Compatibility and identity
The established /v1/stocks/{ticker}/… routes are the recommended endpoints for shared trading data, including ETFs. The /v1/securities/{ticker}/… routes below remain compatibility aliases executing the same actions. No HTTP redirect or extra API call is required. Authentication, plan entitlements, query parameters, response fields, pagination, rounding, and quota charges are identical. Existing clients using either spelling continue to work; use /stocks for new integrations.
An ETF profile is not an operating-company profile. Institutional holders are the investors holding ETF shares; ETF portfolio holdings are the investments owned by the ETF; fund owners are registered funds reporting positions in those ETF shares. These are three different queries.
Coverage is dataset-specific
A route accepting an ETF ticker does not guarantee observations exist. Missing stored data is not evidence of zero activity. Options reference coverage can include listings outside the stored security directory; quote access remains plan-entitled.
Cash dividends are still stored against the current primary listing only, so secondary ETF dividend history is unavailable through the existing dividend endpoint. Do not substitute the registrant's primary dividend. Issuer-trained short-interest forecasts and squeeze scores are not supported ETF analytics; reported short interest and days to cover are supported.
A ticker filter on filings selects its SEC registrant. Returned filings can concern sibling fund series. For a specific ETF's portfolio, use its linked NPORT-P series through /v1/etfs/{ticker}/holdings.
Compatibility aliases
The linked dataset references document the exact parameters, examples and response fields for both route spellings.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/prices.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the prices reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/technicals/atr.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the technicals/atr reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/technicals/bollinger-bands.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the technicals/bollinger-bands reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/technicals/obv.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the technicals/obv reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/technicals/stochastic.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the technicals/stochastic reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/quote.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the quote reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/options/expirations.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the options/expirations reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/options/chain.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the options/chain reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/options/contract.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the options/contract reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/short-volume.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the short-volume reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/short-interest.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the short-interest reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/off-exchange-volume.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the off-exchange-volume reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/institutional-holders.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the institutional-holders reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/institutional-ownership.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the institutional-ownership reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/institutional-activity.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the institutional-activity reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/fund-owners.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the fund-owners reference.
/v1/securities/
Compatibility alias. Recommended stock/ETF route: /v1/stocks/{ticker}/fails-to-deliver.
Parameters: ticker is the exact listed symbol (for example EBS, SPY, or VOO); all other parameters and response fields are unchanged. See the fails-to-deliver reference.