One of the app's features lets you select Vanguard ETFs in the Watchlist and aggregate their holdings to see how often each ticker appears across the selected funds. Repeated holdings make overlapping exposure visible: the more selected funds include a ticker, the greater its potential influence on the portfolio; gains in that holding may help, while declines may hurt, and actual impact also depends on each fund's position size. Another feature makes it faster and easier to find funds with stronger growth over different periods, higher dividend yields or distributions, greater Total Return (price performance plus dividends), and other key performance metrics. A single-file client-side tool that reads the generated ./api/vanguard static feed (official Vanguard fund metrics and holdings, official NAV/premium-discount history merged by date with Yahoo Finance for OHLC/volume and distributions, SEC EDGAR N-PORT-P as fallback) into a searchable ETF/asset-class catalog with per-fund tabs, watchlist aggregation, ticker copy and CSV/TXT export — the same look, feel, columns and business logic as the sibling applications.
bunx degit daggerok/Vanguard#main ./12345 && cd $_
bunx serve . -p 1234
open http://0:1234The published application is available at https://daggerok.github.io/Vanguard/.
Run the updater with Bun:
bun test scripts/update-data.test.ts
./scripts/update-data.tsRun ./scripts/update-data.ts -h (or --help) to print every configuration variable with its default and usage examples.
The Update Vanguard ETF data GitHub Actions workflow exposes the same settings as manual inputs. All supplied filters use AND logic.
| Block | Source |
|---|---|
| Catalog (all US Vanguard ETFs) | https://investor.vanguard.com/etf/list + https://api.vanguard.com/rs/gre/gra/1.7.0/datasets/auw-holdings (official API) |
| Holdings per fund | https://investor.vanguard.com/investment-products/etfs/profile/{TICKER}#holdings (holdings table) |
| Daily NAV/market-price/premium-discount history | Same AdditionalFundData response's historicalPrice + premiumDiscountDetails blocks (official, merged by date; ~21 months of daily premium/discount, longer month-end-only NAV) |
| Daily OHLC/volume; distributions; history fallback | Yahoo Finance chart API — the only source for Open/High/Low/Volume and for dividend/split events, and for any date the official blocks above don't cover |
| Fallback | SEC EDGAR N-PORT-P for holdings fallback |
Each fund carries a derived metrics object that powers the catalog columns shared with the sibling sites:
ytd/tr1y— official YTD and 1-year returns → YTD Return, TR 1Ycagr3y/cagr5y/cagr10y— published annualized 3Y/5Y/10Y figures → CAGR 3Y/5Y/10Ytr3y/tr5y/tr10y— cumulative 3Y/5Y/10Y figures(1 + CAGR)^n - 1→ TR 3Y/5Y/10YsiAnn— since-inception annualized → SI Ann.dividendYield— 12-month trailing yield or indicated yield (latest distribution × frequency ÷ price)secYield— 30-day SEC yield when published;—otherwise
| Environment variable | Default | Meaning |
|---|---|---|
MAX_FETCHES |
all | Batch size: with a positive value the updater continues after the committed cursor in api/vanguard/update-state.json; empty or 0 is a full pass — every fund is refreshed in one run. |
REQUEST_SLEEP |
1 |
Minimum delay in seconds between outgoing request starts, including retries. |
CONCURRENCY |
2 |
Number of parallel fund update workers. Request starts are still globally spaced by REQUEST_SLEEP. |
AUM |
: |
Net Assets range. Each bound may be a USD amount or K/M/B/T, or one of nano, micro, small, mid, large. |
TER |
: |
Expense ratio range in % (strict min:max). |
DIVIDEND_YIELD |
: |
Dividend-yield percentage range. |
TICKERS |
all | Space-, comma- or semicolon-separated ticker allowlist, e.g. VTI VOO BND VUG. |
HOLDINGS_PAGE_SIZE |
250 |
Rows in each generated current-holdings JSON page. |
HISTORY_PAGE_SIZE |
1000 |
Rows in each generated daily-history JSON page. |
MAX_RETRIES |
2 |
Retries after the initial request. Only network errors and HTTP 408/425/429/5xx are retried with exponential backoff. |
SEC_UA |
declared UA | Override the SEC User-Agent. SEC policy requires automated tools to declare a contact. |
SKIP_YAHOO |
off | Skip Yahoo Finance history updates. |
TICKERS combines with AUM, TER, yield filters using AND logic; it does not override them. Funds not selected for a successful update keep their prior published metadata and data files.
MAX_FETCHES=10 ./scripts/update-data.ts
TICKERS="VTI VOO BND VUG" ./scripts/update-data.ts
AUM="1B:" TER=":0.5" ./scripts/update-data.ts
PERFORMANCE_1Y="15:" ./scripts/update-data.tsThe browser app is intentionally build-free: index.html carries the markup, styles and bootstrap, and app.tsx is TypeScript compiled in the browser with Babel standalone — no build step, no bundler, no tsconfig.json needed. Bun runs TypeScript out of the box.
Verification before every publish: bun install --frozen-lockfile, bun test, and git diff --check.
| Brand | Where to get the data |
|---|---|
| Amplify | amplifyetfs.com | Amplify |
| Fidelity | fidelity.com | Fidelity |
| Franklin Templeton | franklintempleton.com | Franklin |
| Global X | globalxetfs.com/explore | Global X |
| Goldman Sachs | am.gs.com | Goldman-Sachs |
| Invesco | invesco.com | Invesco |
| iShares | ishares.com | iShares |
| JPMorgan | am.jpmorgan.com | JPMorgan |
| NEOS | neosfunds.com | Neos |
| ProShares | proshares.com | ProShares |
| Schwab | schwabassetmanagement.com | Schwab |
| SPDR | ssga.com | SPDR |
| VanEck | vaneck.com | VanEck |
| Vanguard | investor.vanguard.com | Vanguard |
| WisdomTree | wisdomtree.com | WisdomTree |
| Application | Data provider | Repository |
|---|---|---|
| Amplify | Amplify ETFs (Firestore data feed) | Amplify |
| Fidelity | SEC EDGAR N-PORT-P + Yahoo Finance | Fidelity |
| Franklin Templeton | franklintempleton.com ETF listings + product pages + SEC EDGAR N-PORT-P | Franklin |
| Global X | globalxetfs.com Next.js catalog and fund pages + dated full-holdings CSV | Global X |
| Goldman Sachs | am.gs.com fund finder + detail pages + SEC EDGAR N-PORT-P | Goldman-Sachs |
| Invesco | invesco.com CSV downloads + Yahoo Finance | Invesco |
| iShares | iShares (BlackRock) product workbooks | iShares |
| JPMorgan | am.jpmorgan.com fund explorer + product-data JSON | JPMorgan |
| NEOS | neosfunds.com lineup table + official fund pages + daily holdings CSV | Neos |
| ProShares | proshares.com ETF finder + fund pages + official data host | ProShares |
| Schwab | schwabassetmanagement.com product pages + CSV exports | Schwab |
| SPDR | SSGA / State Street public feeds | SPDR |
| VanEck | vaneck.com ETF finder + product pages | VanEck |
| Vanguard | Vanguard product pages + SEC EDGAR N-PORT-P | Vanguard |
| WisdomTree | WisdomTree product table + SEC EDGAR N-PORT-P + Yahoo Finance | WisdomTree |
MIT — same as all sibling ETF repositories.
Vanguard® and the fund names/tickers referenced here are trademarks of The Vanguard Group, Inc. This is an independent, unofficial tool; it is not affiliated with, endorsed by, or sponsored by Vanguard. All data is reproduced from Vanguard's own public fund pages, public SEC EDGAR filings and Yahoo Finance for research purposes. All other trademarks, including index names, are the property of their respective owners.