# `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)
