69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
# `zfin quote`
|
|
|
|
Show the latest quote for a symbol, with a price chart and recent
|
|
history.
|
|
|
|
```
|
|
Usage: zfin quote <SYMBOL> [--since <WHEN>] [--export-chart <PATH>]
|
|
```
|
|
|
|
Prints the last price, the day's open/high/low, volume, and the
|
|
day-over-day change, followed by a price chart over a recent window
|
|
(the last ~3 months by default) and a table of the last 20 trading
|
|
days. Quotes come from Yahoo
|
|
(TwelveData fallback) and are **never cached** -- so this command needs
|
|
network access and does nothing useful in `--refresh-data=never` mode.
|
|
|
|
The inline chart renders as a Kitty image (price + Bollinger bands +
|
|
volume + RSI) when your terminal supports it, falling back to a braille
|
|
price line otherwise. Force a mode with the global
|
|
[`--chart`](index.md) flag (`auto` / `braille` / `WxH`).
|
|
|
|
Use `--since <WHEN>` to change how far back the chart reaches. `WHEN`
|
|
accepts an absolute `YYYY-MM-DD`, a relative shortcut (`1W`, `1M`,
|
|
`1Q`, `1Y`), or `ytd`. It governs both the inline chart and the
|
|
`--export-chart` PNG; the 20-day history table is always the last 20
|
|
trading days regardless.
|
|
|
|
Supports `--export-chart <PATH>` to render the chart as a 1920x1080
|
|
PNG instead of text (see [export charts](../../guides/offline-and-refresh.md)
|
|
and the projections page).
|
|
|
|
## Example
|
|
|
|
```bash
|
|
ZFIN_HOME=examples/pre-retirement-both zfin quote SPY
|
|
|
|
# A one-year chart window instead of the default ~3 months:
|
|
ZFIN_HOME=examples/pre-retirement-both zfin quote SPY --since 1Y
|
|
```
|
|
|
|
```
|
|
SPY $746.74 (close)
|
|
========================================
|
|
Date: 2026-06-18
|
|
Open: $747.76
|
|
High: $748.23
|
|
Low: $743.86
|
|
Volume: 80,875,657
|
|
Change (1D): +$5.78 (+0.78%)
|
|
Change (3M): +$31.40 (+4.39%)
|
|
|
|
... (price chart over the selected window -- inline Kitty image, or braille)
|
|
```
|
|
|
|
Two change rows are shown: `Change (1D)` is the day-over-day move,
|
|
and `Change (<span>)` is the move across the chart window (from the
|
|
first visible candle's close to the current price). The span label
|
|
reflects `--since` (`3M` by default; `1Y`, `YTD`, or a date when set).
|
|
In the TUI it's the selected chart timeframe instead (e.g. `Change (1Y)`).
|
|
|
|
## See also
|
|
|
|
- [`perf`](perf.md) -- trailing returns instead of a spot price.
|
|
- [`history`](history.md) -- the last 30 days as a table.
|
|
- [Caching](../../explanation/caching.md#quotes-are-never-cached) -- why quotes need the network.
|
|
|
|
---
|
|
|
|
[CLI command reference](index.md)
|