zfin/docs/reference/cli/exposure.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

44 lines
1.3 KiB
Markdown

# `zfin exposure`
Show how much of a single underlying symbol you really hold -- directly
plus look-through via the top holdings of every ETF in your portfolio.
```
Usage: zfin exposure <SYMBOL>
```
A fund worth $V that holds the symbol at weight w contributes V*w of
exposure. ETF holdings are matched to the symbol by ticker (from the
NPORT-P filing) or by resolving the holding's CUSIP to a ticker
(local cache -> `ZFIN_SERVER` -> OpenFIGI). Holdings with no ticker and
no resolvable CUSIP (bonds, derivatives) are excluded.
ETF profiles come from SEC EDGAR (cached ~90 days), so the first run on
a cold cache fetches them and can take ~15s. Requires `ZFIN_USER_EMAIL`.
## Example
```bash
ZFIN_HOME=examples/pre-retirement-both zfin exposure SPY
```
```
Exposure to SPY (examples/pre-retirement-both/portfolio.srf)
========================================
Total exposure 17.3% $238,956.80
Direct 17.3% $238,956.80
Look-through 0.0% $0.00
```
This is most useful for an individual stock you also hold inside broad
ETFs -- e.g. `zfin exposure NVDA` to see your true concentration across
VTI, SPY, and QQQ.
## See also
- [Read your portfolio](../../guides/read-your-portfolio.md#exposure-look-through-to-a-single-symbol)
- [`etf`](etf.md) -- the holdings that drive look-through.
---
[CLI command reference](index.md)