Stock Analysis API: Get ETF holdings
Gets an ETF's free holdings list from Stock Analysis by ticker or exact fund name: each holding's weight and shares, plus the fund's expense ratio, total number of holdings, holdings date and exact assets under management when shown.
Unofficial. Not affiliated with or endorsed by Stock Analysis.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Etf, required
etf ETF name or ticker, for example Vanguard S&P 500 ETF or VOO.
VOO
- Max Results optional
max_results Maximum holdings to return, for example 10; never more than the free list.
25 (default)
Whole number from 1 to 100.
Input as JSON
{ "etf": "VOO"}Output
{ "ticker": "VOO", "etf_name": "Vanguard S&P 500 ETF", "holdings": [ { "name": "NVIDIA Corporation", "rank": 1, "ticker": "NVDA", "page_url": "https://stockanalysis.com/stocks/nvda/" , "shares_held": 643435730, "weight_percent": 8.08 }, { "name": "Apple Inc.", "rank": 2, "ticker": "AAPL", "page_url": "https://stockanalysis.com/stocks/aapl/" , "shares_held": 390202069, "weight_percent": 7.03 }, { "name": "Microsoft Corporation", "rank": 3, "ticker": "MSFT", "page_url": "https://stockanalysis.com/stocks/msft/" , "shares_held": 197352378, "weight_percent": 5.7 } ], "page_url": "https://stockanalysis.com/etf/voo/holdings/" , "holdings_date": "2026-08-31", "number_of_holdings": 516, "expense_ratio_percent": 0.03, "assets_under_management_usd": 1041349610639}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"stockanalysis.com/get_etf_holdings","input":{"etf":"VOO"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "stockanalysis.com/get_etf_holdings" , "input": { "etf": "VOO" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "stockanalysis.com/get_etf_holdings" , "input": { "etf": "VOO" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run stockanalysis.com/get_etf_holdings# with {"etf":"VOO"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "etf" ], "properties": { "etf": { "type": "string", "description": "ETF name or ticker, for example Vanguard S&P 500 ETF or VOO." }, "max_results": { "type": "integer", "default": 25, "maximum": 100, "minimum": 1, "description": "Maximum holdings to return, for example 10; never more than the free list.", "x-fous-developer": true } }}Output schema
{ "type": "object", "required": [ "etf_name", "ticker", "expense_ratio_percent", "assets_under_management_usd", "number_of_holdings", "holdings_date", "page_url", "holdings" ], "properties": { "ticker": { "type": "string", "description": "ETF ticker." }, "etf_name": { "type": "string", "description": "ETF name." }, "holdings": { "type": "array", "items": { "type": "object", "required": [ "rank", "name", "ticker", "weight_percent", "shares_held", "page_url" ], "properties": { "name": { "type": "string", "description": "Company or asset name." }, "rank": { "type": "integer", "description": "Position by weight." }, "ticker": { "type": [ "string", "null" ], "description": "Holding ticker, when shown." }, "page_url": { "type": [ "string", "null" ], "description": "Stock Analysis page for this holding, when linked." }, "shares_held": { "type": [ "integer", "null" ], "description": "Number of shares held, when shown." }, "weight_percent": { "type": "number", "description": "Share of the fund, in percent." } } }, "description": "Largest free holdings first." }, "page_url": { "type": "string", "description": "Stock Analysis ETF holdings page." }, "holdings_date": { "type": "string", "format": "date", "description": "Date the listed holdings were reported." }, "number_of_holdings": { "type": "integer", "description": "Total number of holdings in the ETF." }, "expense_ratio_percent": { "type": [ "number", "null" ], "description": "Annual expense ratio in percent, when shown." }, "assets_under_management_usd": { "type": [ "integer", "null" ], "description": "Exact assets under management in USD, when shown." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
stockanalysis.com/get_etf_holdings- Returns
- ETF name, ticker, expense ratio, assets under management, number of holdings, holdings date, holdings with rank, name, ticker, weight, shares, page link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method stockanalysis.com/get_etf_holdings with the inputs above.
Ask your agent
- What are the top 10 holdings in QQQ and how much of the fund does each one make up?
- Pull the holdings list for the iShares Core MSCI Emerging Markets ETF from stockanalysis.com, including the expense ratio and AUM
- I need to see what SCHD actually owns: share counts, weights, and the date the holdings were last updated
- Check Stock Analysis for the ARK Innovation ETF's current positions, top 25 is fine
- How many stocks does VTI hold, what's its expense ratio, and which 15 names have the biggest weightings?
See more
All Stock Analysis methodsLooks up a stock by company name or ticker on Stock Analysis and returns its valuation ratios and company statistics, with the date the figures were last updated.
stockanalysis.com/get_key_statisticsLooks up a company by name or ticker on Stock Analysis and returns its annual or quarterly income statement, balance sheet, or cash flow statement for the free periods.
stockanalysis.com/get_financial_statementsLists US IPOs from a chosen year, newest first. Each IPO comes with its IPO price, current price and return since IPO. Coverage begins in 2019.
stockanalysis.com/list_recent_iposFinds publicly listed stocks in a country, filtered by sector, US-dollar market cap band and minimum dividend yield, in the requested order. Quotes may be delayed.
tradingview.com/screen_stocksFinds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date.
sec.gov/get_company_filingsGet a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null.
finviz.com/get_stock_snapshotScreens US-listed stocks on Finviz by sector, company size, minimum dividend yield, maximum P/E ratio and market signal, ranked by market value, today's gain or dividend yield.
finviz.com/screen_stocksLooks up an Ethereum wallet on Etherscan by address or ENS name: its ETH balance and USD value, the largest displayed ERC-20 holdings, and the newest confirmed transactions. Pending transactions are excluded; unpriced holdings have no USD value.
etherscan.io/get_wallet