45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
# `watchlist.srf` reference
|
|
|
|
A watchlist tracks the price of symbols you don't own. Watchlist
|
|
symbols appear at the bottom of the portfolio view (and the TUI
|
|
Portfolio tab) showing their latest price, with no position, cost, or
|
|
weight.
|
|
|
|
zfin loads `watchlist.srf` from `ZFIN_HOME` (or the current
|
|
directory), or from an explicit path with the `-w` / `--watchlist`
|
|
flag. It is optional.
|
|
|
|
## File format
|
|
|
|
One `symbol::` per line, under the standard `#!srfv1` header:
|
|
|
|
```srf
|
|
#!srfv1
|
|
symbol::MSFT
|
|
symbol::NVDA
|
|
symbol::TSLA
|
|
```
|
|
|
|
## Two ways to watch a symbol
|
|
|
|
| Approach | When to use |
|
|
|---------------------------------------------------------------------|---------------------------------------------------------------------------|
|
|
| A `watchlist.srf` file (above) | A standalone list you reuse across portfolios, or one you pass with `-w`. |
|
|
| A `security_type::watch` lot in [`portfolio.srf`](portfolio-srf.md) | You want the watch entry to live alongside your holdings. |
|
|
|
|
```srf
|
|
# Equivalent watch entry inside portfolio.srf
|
|
security_type::watch,symbol::NVDA
|
|
```
|
|
|
|
The two sources are merged: the effective watchlist is the union of
|
|
the watchlist file and any `watch` lots in the portfolio.
|
|
|
|
## See also
|
|
|
|
- [`portfolio.srf`](portfolio-srf.md) -- the `watch` security type.
|
|
- [`zfin quote`](../cli/quote.md) -- a one-off price check without adding to a watchlist.
|
|
|
|
---
|
|
|
|
[Documentation home](../../README.md#reference)
|