Stock Earnings Filing Tracker

Track US company earnings filings from SEC EDGAR. Past rows are 8-K Item 2.02 filing dates, not necessarily the time the earnings release first appeared. Without a symbol filter, future rows are unconfirmed estimates based on the same fiscal-quarter filing 52 weeks earlier, aligned to the weekday. For supplied symbols, the actor also uses recent Item 2.02 filing intervals. A company-announced date explicitly found in an SEC 8-K Item 7.01/8.01 is marked confirmed; an already-filed Item 2.02 is marked reported. Check date_status, date_is_estimated, date_method, and the supporting source_url before using a date. SEC public filing content is free to access and reuse.

Quick start

{"mode":"upcoming","daysAhead":7,"limit":10}

Without symbols, the actor builds a dynamic company universe from the SEC's own 8-K filing search index (up to 2,000 matching prior-year documents per window). Supply symbols, for example ["AAPL", "MSFT"], to inspect specific SEC-listed companies. recent queries past filings; search queries a wider window. A company without a matching prior-year filing may be absent. SEC outages or a quiet date window may yield zero rows.

Output and limitations

The existing output keys are retained. EDGAR provides symbol, name, a filing-derived report_date, industry (SEC SIC description, where available), source_url, and date-relative fields. nextEarningsDate is populated from the report_date for future rows; date_status distinguishes estimated from confirmed dates.

SEC does not publish analyst consensus, a confirmed earnings announcement time, current quote/market cap, or stock sector. Accordingly eps_forecast, num_estimates, revenue_forecast_usd, market_cap_usd, sector, current_price_usd, pe_ratio, forward_pe, and consensus-based beat analytics remain null. For a released Item 2.02 filing only, eps_actual and revenue_actual_usd may be filled from an unambiguous company-authored Exhibit 99.1 statement in that filing; otherwise they remain null.

New, separate expectation fields are not consensus. eps_guidance_low/high, revenue_guidance_low/high, guidance_period, their *_source fields, and guidance_source_url come only from explicit forward ranges in a company's own SEC-filed Exhibit 99.1; guidance_basis distinguishes adjusted from unqualified EPS. eps_model_estimate uses the same calendar quarter's prior-year diluted EPS plus the latest observed year-over-year EPS change from SEC XBRL company-concept facts, with eps_model_source_url pointing to the source. eps_model_mae_8q is its rolling absolute-error mean over the latest eight observed quarters, with eps_model_backtest_n showing how many could be predicted. The model requires at least four backtested observations to publish an MAE; eps_surprise/eps_surprise_pct are computed against the model only when that MAE exists, and eps_surprise_source is then model:v1. A Q4 EPS value inferred as annual minus nine-month EPS is approximate. See ../../docs/discuss/stock_earnings_model_backtest.md.

timing is an estimated BMO/DMH/AMC classification from the latest eight available prior SEC Item 2.02 8-K acceptance timestamps (at least two required). Before 09:30 New York time is BMO, 09:30–15:59 is DMH, and 16:00 onward is AMC. The majority wins; ties use the most recent vote. timing_status=estimated, timing_source=sec_acceptance_hour, and timing_source_url identify the estimate; acceptance is not a confirmed earnings-release time. Unzoned or invalid timestamps remain unusable. The SIC industry label is not mapped to a stock-market sector. The old enrichWithMarketData and includeGuide switches are accepted for compatibility but do not enable vendor data. A positive minMarketCapUsd or nonempty sectors filter therefore cannot match rows. Sorting by unavailable metrics falls back to date/symbol order.

The EPS model requires at least eight observed quarters and the seasonal inputs required by model:v1; ambiguous already-reported target quarters remain null. Where a nine-month EPS tag is absent, Q4 can be approximated from annual EPS minus three contiguous standalone quarters. Timing/EPS enrichment is prioritized ahead of later archive guidance within the existing deadline, with the first batch still delivered promptly. Company-announced dates require explicit future-tense earnings language in an SEC-filed document and a date after its filing date; date_source_url identifies the evidence. Discovery is bounded to two search pages and 20 matching documents per run, so confirmed-date coverage is not exhaustive. No cadence-based date is marked confirmed.

Telegram alerts, when configured with your bot token and chat ID, label each date's status. The SUMMARY key-value record reports row counts and the source. The actor never requests data from a market-data provider whose terms prohibit redistribution.

Pricing

The actor keeps the existing pay-per-event names: apify-actor-start and earnings-tracked. The first 25 rows per account are a one-time free allowance; check the Store pricing tab for the current prices.

SEC fair-access rules require an identified User-Agent and a request rate below 10 per second. This actor serializes SEC requests with a short gap. Set SEC_CONTACT_EMAIL to the operator's own address when deploying under another operator; the default contact is the actor owner's address.