zfin/docs/reference/cli/quote.md

2 KiB

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 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 and the projections page).

Example

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:        +$5.78 (+0.78%)

  ... (price chart over the selected window -- inline Kitty image, or braille)

See also

  • perf -- trailing returns instead of a spot price.
  • history -- the last 30 days as a table.
  • Caching -- why quotes need the network.

CLI command reference