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

906 B

zfin divs

Show dividend history for a symbol, with trailing-twelve-month yield.

Usage: zfin divs <SYMBOL>

Lists each dividend's ex-date, amount, pay date, and type (regular, special, etc.). Dividend data comes from Polygon (POLYGON_API_KEY), merged with per-row dividend data from Tiingo's price series.

Example

ZFIN_HOME=examples/pre-retirement-both zfin divs SCHD
Dividend History for SCHD
========================================
     Ex-Date     Amount     Pay Date       Type
------------ ---------- ------------ ----------
2026-03-25       0.2569 2026-03-30      regular
2025-12-10       0.2782 2025-12-15      regular
2025-09-24       0.2604 2025-09-29      regular
...

See also

  • splits -- corporate splits for a symbol.
  • perf -- total return, which includes reinvested dividends.

CLI command reference