ARK Invest

One of the app's features lets you select ARK Invest 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/ark static feed (ark-funds.com ETF pages and per-fund overview, NAV-history and performance JSON — official NAV returns, expenses, net assets and whole-life NAV/market-price history — plus the official daily holdings CSV files, with SEC EDGAR N-PORT-P and Yahoo Finance as fallbacks) 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/ARK#main ./12345 && cd $_
bunx serve . -p 1234
open http://0:1234

The published application is available at https://daggerok.github.io/ARK/.

Run the updater with Bun:

bun test
bun scripts/update-data.ts

Run bun scripts/update-data.ts -h (or --help) to print every configuration variable with its default and usage examples.

Defaults live in scripts/update-data.config.json (every control as a string). Explicit environment variables override the file; an ARK_<KEY> alias (for example ARK_CONCURRENCY) wins over the plain <KEY> when both are set. The Update ARK Invest ETF data GitHub Actions workflow uses the same resolveControls resolver: individual workflow_dispatch inputs are blank by default and inherit the file, the advanced input accepts a JSON object with any control, and the precedence is file defaults < advanced JSON < nonblank individual inputs < protected Actions variable/env. GitHub allows at most 25 inputs, so controls without an individual input (see the workflow) are set through advanced (for example {"VERBOSE":"true"}). Scheduled runs have no inputs and use the file defaults. The real SEC contact belongs in the protected repository Actions variable SEC_UA, which wins when nonblank; the config default is daggerok ETF feed daggerok@gmail.com. An explicitly set environment variable wins even when empty (it clears the control), and invalid values fail with an error instead of falling back silently. All supplied filters use AND logic.

All issuer requests go directly to ark-funds.com with a short contact-bearing User-Agent (daggerok ETF feed daggerok@gmail.com). The site's Cloudflare WAF answers HTTP 403 to any User-Agent that contains a URL (the crawler-style (+https://github.com/…)) and challenges browser User-Agents sent from a non-browser TLS stack, so the updater deliberately uses neither. A first HTTP 403 is retried once directly (a transient WAF challenge may pass); if that is denied too, this very request and all remaining issuer requests go through the read-only r.jina.ai reader (one [ issuer ] notice; that reader is limited to roughly 20 requests per minute, so proxied requests are spaced at least 3.2 seconds apart across the whole run and retried at most once). A previously published fund page ID is reused when the overview endpoint confirms it still answers for the same ticker, which skips the heaviest page download on repeat runs; IDs are never hard-coded. Holdings CSVs, SEC EDGAR and Yahoo Finance are always fetched directly. A fund is either fully refreshed or kept exactly as published: when a required source fails (official fund page, overview, NAV history, performance, holdings CSV, Yahoo chart) the fund's previous complete state stays untouched and the run reports it as failed. The workflow may therefore commit a partial run safely. A fund that has never been published is written best-effort from whatever sources answered. A run in which every selected fund failed exits non-zero.

Each fund carries a derived metrics object that powers the catalog columns shared with the sibling sites:

• ytd / tr1y — official YTD and 1-year NAV returns → YTD Return, TR 1Y

• cagr3y / cagr5y / cagr10y — published annualized 3Y/5Y/10Y figures → CAGR 3Y/5Y/10Y

• tr3y / tr5y / tr10y — cumulative 3Y/5Y/10Y figures (1 + CAGR)^n - 1 → TR 3Y/5Y/10Y

• siAnn — since-inception annualized → SI Ann.; only for funds at least one year old (and, for Yahoo-derived values, only when the history window reaches the first trade, so HISTORY_RANGE=2y never labels the window start as inception). Horizons longer than the fund's age (for example 3Y for a fund under three years old) are null

• dividendYield — indicated yield (latest Yahoo Finance distribution × inferred payments per year ÷ market price; monthly 12, quarterly 4, semi-annual 2, annual 1) or trailing 12-month yield; — when no distributions are reported

• secYield — 30-day SEC yield when published on the fund page; null otherwise (an honest null is never replaced by an older number)

• returnsBasis — always a non-empty label of how the returns were computed: official ARK Invest NAV total returns, Yahoo Finance adjusted close estimates, or the previous publication's label when both sources are down (never empty and never -). All return figures of a fund come from one source as a unit (no per-figure mixing): a figure ARK later nulls stays null

• performanceAsOf — ISO YYYY-MM-DD date the returns are as of: the month-end date of the ark-funds.com performance table for official returns, the Yahoo close the derived returns end on (the last close at or before the month end); null when unknown. It is not the NAV date

• Every metrics object carries the full key set in a fixed order, with returnsBasis and performanceAsOf last; unavailable values are null

• Official NAV returns come from ark-funds.com; market-price history and distribution-based yields come from Yahoo Finance and are estimates, not official figures

• Unavailable values are shown as — and are never written as 0

• ARKVX (an interval fund) is excluded from the catalog; ARKY uses a structured-note holdings layout

• The 14-fund catalog stays built in: the official ETF page lists only fund slugs (no names, CSV file names or trust data), so a new ARK fund cannot be fully described automatically. Each run reads the page, prints NEW FUNDS: A, B (also appended to $GITHUB_STEP_SUMMARY) for any fund that is listed there or missing from the previous index, and the fund must then be added to ARK_FUNDS

• TER: ARK publishes one expense ratio (the fund page EXPENSE RATIO, or TOTAL FEES); it is published as terValue (net, the only figure available) and no gross figure is invented

• Holdings asOfDate is the newest row date of the CSV; a snapshot older than 7 days is always printed as a [ stale ] warning and an N-PORT-P fallback never replaces holdings that are newer than its report period

• The index row of a fund without funds/<T>/meta.json has dataFile: null and a full metrics object of nulls

• Each fund records its holdings source (official CSV or SEC EDGAR N-PORT-P fallback) and as-of date; a fund whose sources fail keeps its previously published data

TICKERS combines with AUM, TER, yield and return 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=3 bun scripts/update-data.ts
CONCURRENCY=15 bun scripts/update-data.ts
TICKERS="ARKK ARKW ARKG ARKB" bun scripts/update-data.ts
AUM="1B:" TER=":0.75" bun scripts/update-data.ts
PERFORMANCE_1Y="15:" bun scripts/update-data.ts

The 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
bun build --target=bun scripts/update-data.ts --outfile=/dev/null
git diff --check

Config, README and --help parity, workflow shape and parser checks all run as part of bun test.

MIT - same as all sibling ETF repositories

ARK®, ARK Invest® and the fund names/tickers referenced here are trademarks of ARK Investment Management LLC. This is an independent, unofficial tool; it is not affiliated with, endorsed by, or sponsored by ARK Investment Management LLC or ARK ETF Trust. All data is reproduced from ARK Invest's own public fund pages and downloads, public SEC EDGAR filings and Yahoo Finance for research purposes. All other trademarks, including index names, are the property of their respective owners.