Earnings Calendar API

Endpoint

GET /v1/earnings/calendar

Auth required (X-Api-Key) Rate Limited: Yes Growth plan+

Parameters

Name	In	Required	Default	Description
`days`	query	no	`14`	Forward window in days. Clamped to 1-90.
`symbols`	query	no	-	Comma-separated list of symbols to filter to (case-insensitive, e.g. AAPL,MSFT). Omit for the full calendar.
`importance`	query	no	-	Minimum importance rating; only events with importance >= this value are returned.

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://lab.flashalpha.com/v1/earnings/calendar?days=14&symbols=AAPL,MSFT&importance=3"

import requests

resp = requests.get(
    "https://lab.flashalpha.com/v1/earnings/calendar",
    headers={"X-Api-Key": "YOUR_API_KEY"},
    params={"days": 14, "symbols": "AAPL,MSFT", "importance": 3}
)
data = resp.json()
print(f"{data['count']} upcoming events")

const resp = await fetch(
  "https://lab.flashalpha.com/v1/earnings/calendar?days=14&symbols=AAPL,MSFT&importance=3",
  { headers: { "X-Api-Key": "YOUR_API_KEY" } }
);
const data = await resp.json();
console.log(data.count + " upcoming events");

API Key

Response

{
  "events": [
    {
      "symbol": "AAPL",
      "company_name": "Apple Inc",
      "earnings_date": "2026-06-09",
      "timing": "amc",
      "is_confirmed": true,
      "fiscal_period": "Q3",
      "fiscal_year": 2026,
      "importance": 5,
      "eps_estimate": 1.42,
      "implied_move_pct": 4.8,
      "days_to_event": 4
    }
  ],
  "count": 1
}

Key Response Fields

Field	Description
`events[].timing`	Session of the report - typically `bmo` (before market open) or `amc` (after market close); may be null/unknown.
`events[].is_confirmed`	Whether the date is confirmed (vs. estimated) by the provider.
`events[].importance`	Provider importance rating (higher = more market-moving); nullable.
`events[].eps_estimate`	Consensus EPS estimate; nullable.
`events[].implied_move_pct`	Stored earnings-implied move (%), if available; nullable.
`events[].days_to_event`	Calendar days from today (UTC) to the earnings date.

Errors

Status	Description
`400`	Invalid query parameter.
`403`	Caller is below the Growth tier.
`404`	`no_data` - no upcoming earnings in the requested window.

About

Returns the upcoming earnings calendar across a forward window (default 14 days, up to 90). Filter to a watchlist with symbols or focus on the most market-moving names with the importance threshold.

Earnings event data (dates, EPS estimates, fiscal periods, importance) is sourced from Finnhub. The implied_move_pct field carries the stored earnings-implied move when available.

Common Use Cases

Build an earnings-week watchlist by filtering the events array to high-importance names over a forward days window
Schedule pre-earnings analytics jobs keyed off days_to_event so straddle and IV-crush pulls fire at the right lead time
Surface upcoming reports for portfolio holdings by passing your watchlist to symbols
Flag confirmed vs. estimated dates with is_confirmed before committing capital to a date-dependent trade
Route around session risk using timing (bmo vs. amc) to time entries and overnight exposure
Seed a consensus-vs-actual tracker from eps_estimate to grade post-report surprises
Pre-rank names by the stored implied_move_pct to spot the biggest expected movers in the window

Complementary endpoints

Earnings overview - the hub that ties every earnings sub-endpoint together
Earnings Screener - rank the same window by VRP, crush, or importance in one call
Earnings Expected Move - decompose the implied move once a date is on the calendar