zfin/docs/reference/cli/splits.md
Emil Lerch c08e89a025
All checks were successful
Generic zig build / build (push) Successful in 4m53s
Generic zig build / publish-macos (push) Successful in 11s
Generic zig build / deploy (push) Successful in 20s
update docs for split adjustment
2026-07-06 14:09:18 -07:00

47 lines
1.1 KiB
Markdown

# `zfin splits`
Show stock-split history for a symbol.
```
Usage: zfin splits <SYMBOL>
```
Lists each split's effective date and ratio. Split data comes from
Polygon (`POLYGON_API_KEY`), merged with per-row split factors from
Tiingo's price series (which rescues events Polygon's reference
endpoint occasionally misses).
This is the same split feed that drives portfolio split adjustment: to
have a split reflected in your holdings' effective shares, set
[`splits_current_through`](../config/metadata-srf.md#stock-split-adjustment)
on the symbol's `metadata.srf` row.
## Example
```bash
zfin splits AAPL
```
```
Split History for AAPL
========================================
Date Ratio
------------ ----------
2020-08-31 4:1
2014-06-09 7:1
2005-02-28 2:1
2000-06-21 2:1
1987-06-16 2:1
5 split(s)
```
## See also
- [`divs`](divs.md) -- dividend history for a symbol.
- [`history`](history.md) -- split-adjusted price history.
- [`metadata.srf`](../config/metadata-srf.md#stock-split-adjustment) -- apply a split to your holdings via `splits_current_through`.
---
[CLI command reference](index.md)