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