zfin/docs/reference/cli/quote.md

52 lines
1.5 KiB
Markdown

# `zfin quote`
Show the latest quote for a symbol, with a price chart and recent
history.
```
Usage: zfin quote <SYMBOL>
```
Prints the last price, the day's open/high/low, volume, and the
day-over-day change, followed by a price chart of the last 60 candles
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`).
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
```
```
SPY $746.74 (close)
========================================
Date: 2026-06-18
Open: $747.76
High: $748.23
Low: $743.86
Volume: 80,875,657
Change: +$5.78 (+0.78%)
... (60-candle price chart -- inline Kitty image, or braille)
```
## 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)