zfin/docs/reference/cli/etf.md
Emil Lerch 74fc219afd
All checks were successful
Generic zig build / build (push) Successful in 5m48s
Generic zig build / publish-macos (push) Successful in 11s
Generic zig build / deploy (push) Successful in 23s
add docs/guides
2026-06-22 14:53:53 -07:00

47 lines
969 B
Markdown

# `zfin etf`
Show an ETF's profile: net assets, holdings count, sector allocation,
and top holdings.
```
Usage: zfin etf <SYMBOL>
```
Profile data comes from SEC EDGAR's NPORT-P filings, so it requires
`ZFIN_USER_EMAIL` (EDGAR mandates a contact address in the request).
## Example
```bash
ZFIN_HOME=examples/pre-retirement-both zfin etf SPY
```
```
ETF Profile: SPY
========================================
Net Assets: $651.6B
Total Holdings: 20
Sector Allocation:
98.1% Equity / Corporate
1.9% Equity / Other
Top Holdings:
Symbol Weight Name
-- 7.58% NVIDIA Corp
-- 6.66% Apple Inc
-- 4.91% Microsoft Corp
...
```
The same NPORT-P holdings power [`exposure`](exposure.md)'s
look-through analysis.
## See also
- [`exposure`](exposure.md) -- your true exposure to a symbol through ETFs.
- [`enrich`](enrich.md) -- uses EDGAR data to classify holdings.
---
[CLI command reference](index.md)