Skip to main content

Documentation Index

Fetch the complete documentation index at: https://scalarfield.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Python function: getEarningsData()
SpecificationValue
Delivery Frequencycontinuous, real-time
Data Frequencyevent-driven (quarterly earnings)
CoverageAll US equities with earnings reports
SourceBenzinga
AvailabilityFree

​
Product Overview

​
Overview

Earnings Calendar & Results provides structured data on quarterly earnings reports for US equities. The dataset includes both historical results (actual EPS vs. consensus estimates) and upcoming scheduled reports (with estimated EPS and release timing). Each row represents a single earnings event for a company — the date of the report, the fiscal period, the time of release, and the actual and estimated EPS values.

​
Data Pipeline

Scalar Field proxies earnings data in real-time from the Benzinga API. Each query fetches live data directly — there is no local caching delay. This means upcoming earnings dates and freshly reported results are available as soon as the upstream source publishes them.

​
Querying the Data

​
Basic Usage

from scalarlib import getEarningsData

# Earnings for specific tickers in a date range
data = getEarningsData(['AAPL', 'GOOGL', 'MSFT'], '2025-01-01', '2025-12-31')
aapl_earnings = data['AAPL']

# All tickers with earnings in a date range
data = getEarningsData(None, '2025-01-01', '2025-12-31')
For upcoming earnings, set end_date to a future date. epsActual will be None for reports that have not yet been released.

​
Parameters

ParameterTypeRequiredDescription
tickerslist of str or NoneNoStock symbol(s). None returns all tickers with earnings in the date range.
start_datestrYesStart date (YYYY-MM-DD).
end_datestrYesEnd date (YYYY-MM-DD). Use a future date to include upcoming earnings.

​
Return Schema

Returns Dict[str, pd.DataFrame] keyed by ticker symbol. Each DataFrame:
ColumnTypeDescription
Datedatetime64[ns]Date of the earnings report
symbolstringTicker symbol
earningsReportPeriodstringFiscal period (e.g. "2025-Q3")
earnings_timestringTime of release (e.g. "16:30:00")
epsActualfloat or NoneActual earnings per share. None for future earnings that have not yet been reported.
epsEstimatefloatConsensus EPS estimate prior to the report
When aligning earnings data with price data, remember that earnings dates may fall on non-trading days. Use getClosestTradingDate() to find the nearest trading session.