45 lines
1.2 KiB
Markdown
45 lines
1.2 KiB
Markdown
# `zfin earnings`
|
|
|
|
Show earnings history (with EPS surprise) and upcoming events for a
|
|
symbol.
|
|
|
|
```
|
|
Usage: zfin earnings <SYMBOL>
|
|
```
|
|
|
|
Lists each quarter's report date, EPS estimate, actual EPS, and the
|
|
surprise (absolute and percent), plus upcoming scheduled dates. Data
|
|
comes from FMP (`FMP_API_KEY`).
|
|
|
|
ETFs, mutual funds, CUSIPs, and some dual-class shares (e.g. BRK.B)
|
|
have no earnings on FMP's free tier and show as "no earnings data" --
|
|
an expected limitation, not a bug.
|
|
|
|
## Example
|
|
|
|
```bash
|
|
zfin earnings AAPL
|
|
```
|
|
|
|
```
|
|
Earnings History for AAPL
|
|
========================================
|
|
Date Q EPS Est EPS Act Surprise Surprise %
|
|
------------ ---- ------------ ------------ ------------ ----------
|
|
2026-07-30 Q2 $1.75 -- -- --
|
|
2026-04-30 Q1 $1.95 $2.01 +$0.0600 +3.1%
|
|
2026-01-29 Q4 $2.67 $2.85 +$0.1800 +6.7%
|
|
...
|
|
```
|
|
|
|
A row with `--` in the actual column is a scheduled, not-yet-reported
|
|
quarter.
|
|
|
|
## See also
|
|
|
|
- [Why multiple data providers](../../explanation/data-providers.md) -- earnings coverage limits.
|
|
- [`etf`](etf.md) -- the profile view for funds (which have no earnings).
|
|
|
|
---
|
|
|
|
[CLI command reference](index.md)
|