Skip to main content
GET
/
v1
/
calendars
/
earnings
Python (SDK)
from datetime import date
from finance_dev import FinanceDev, models
import os


with FinanceDev(
    security=models.Security(
        client_id=os.getenv("FINANCEDEV_CLIENT_ID", ""),
        client_secret=os.getenv("FINANCEDEV_CLIENT_SECRET", ""),
    ),
) as fd_client:

    res = fd_client.calendar.get_earnings_calendar(from_=date.fromisoformat("2024-01-01"), to=date.fromisoformat("2024-01-31"), symbol="AAPL")

    # Handle response
    print(res)
[
  {
    "date": "<string>",
    "epsActual": 123,
    "epsEstimate": 123,
    "hour": "<string>",
    "quarter": 123,
    "revenueActual": 123,
    "revenueEstimate": 123,
    "symbol": "<string>",
    "year": 123
  }
]

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

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

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

from
string<date>
required

Start date in YYYY-MM-DD format

Example:

"2024-01-01"

to
string<date>
required

End date in YYYY-MM-DD format

Example:

"2024-01-31"

symbol
string

Optional stock symbol to filter results. If not provided, returns earnings for all symbols.

Example:

"AAPL"

Response

Earnings calendar data retrieved successfully

date
string

Earnings release date

epsActual
number | null

Actual earnings per share

epsEstimate
number | null

Estimated earnings per share

hour
string

Time of day for earnings release (e.g., 'bmo' for before market open, 'amc' for after market close)

quarter
integer

Quarter number (1-4)

revenueActual
number | null

Actual revenue

revenueEstimate
number | null

Estimated revenue

symbol
string

Stock ticker symbol

year
integer

Year of the earnings