zfin/docs/reference/cli/earnings.md
Emil Lerch 74fc219afd
All checks were successful
Generic zig build / build (push) Successful in 5m48s
Generic zig build / publish-macos (push) Successful in 11s
Generic zig build / deploy (push) Successful in 23s
add docs/guides
2026-06-22 14:53:53 -07:00

1.2 KiB

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

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


CLI command reference