37 lines
906 B
Markdown
37 lines
906 B
Markdown
# `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
|
|
|
|
```bash
|
|
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`](splits.md) -- corporate splits for a symbol.
|
|
- [`perf`](perf.md) -- total return, which includes reinvested dividends.
|
|
|
|
---
|
|
|
|
[CLI command reference](index.md)
|