Earnings calendar API,
dates, EPS and surprises.

Earnings calendar fields

Earnings belong to the issuer. company_id identifies the company and instruments lists the listings it applies to, with each symbol and stable instrument_id, so a calendar row joins directly to prices. fiscal_year and fiscal_quarter place the quarter on the company's fiscal calendar, taken from the fiscal year ends of its annual statements: Apple's quarter ending June 2026 is the third quarter of fiscal 2026, which ends in September. The year is the calendar year in which the fiscal year ends, so a company that names a year ending in January after the year it began in calls it one less. Both are null for an event known only from the earnings calendar and for quarters the annual statements do not place; period_end is the reliable period key. period_start is always null.

When report_date is null, the from and to filters and the ordering fall back to period_end, so an announcement with no known date still appears in the right place.

How earnings dates are set

Upcoming dates start as estimated, a projection from the company's reporting cycle. They become confirmed when the company announces the date and reported once results are out. Build user-facing calendars to show the difference: an estimated date can move by days. A date that cannot be supported is left null rather than guessed.

# Every announcement in the week of October 12, 2026
curl 'https://api.ohlc.io/v1/earnings?from=2026-10-12&to=2026-10-16&limit=500' \
  -H "Authorization: Bearer $OHLC_API_KEY"

Consensus estimates and revisions

/v1/estimates returns the latest consensus snapshot for each company, metric and fiscal period: metric=eps, revenue or ebitda, with period=quarterly or annual. Each row has mean, median, high and low value objects, analyst_count, and revisions_up and revisions_down over revision_window_days. On October 3, 2026, Apple's quarterly EPS consensus for the period ending September 30 drew on 27 analysts, with 7 upward and 14 downward revisions over 30 days.

Use cases

• Earnings calendars and reminders in a trading or portfolio app.
• Post-earnings drift studies: join to daily bars and use timing to pick the session that reacted. After-market reports move the next session.
• Surprise history per company for a beat-rate statistic.
• Estimate revision tracking ahead of a report.

Point in time, history and plans

as_of keeps later changes out of an earlier answer, including a status that moved from estimated to reported. Knowledge history starts in late September 2026, when OHLC began recording these datasets. The announcements reach further back: on October 3, 2026, Apple's earnings history began with the period ending December 31, 1993.

Earnings are included on every plan, Free through Scale, at 25 credits per request. Consensus estimates are on Pro, Commercial and Scale, at 50 credits per symbol or 500 credits for a whole-market page. See pricing.

curl 'https://api.ohlc.io/v1/earnings?symbols=XNAS:AAPL&from=2026-07-01&to=2026-12-31' \
  -H "Authorization: Bearer $OHLC_API_KEY"

{
  "data": [
    {
      "id": "record_a54c75c7b158e68611b4",
      "company_id": "01M35H2KDW9VT69S5ZCEGMCPAX",
      "instruments": [
        { "instrument_id": "01M35H2KE2ZJHXFY5C3E7FPC66", "symbol": "XNAS:AAPL", "name": "Apple Inc." }
      ],
      "period_start": null,
      "period_end": "2026-06-30",
      "fiscal_year": 2026,
      "fiscal_quarter": 3,
      "period": "quarterly",
      "report_date": "2026-07-30",
      "report_at": null,
      "timing": "after_market",
      "status": "reported",
      "eps_actual": { "amount": "2.02", "currency_code": "USD" },
      "eps_estimate": { "amount": "1.88", "currency_code": "USD" },
      "eps_surprise": { "amount": "0.14", "currency_code": "USD" },
      "eps_surprise_ratio": "0.074468",
      "revenue_actual": { "amount": "109417000000.00", "currency_code": "USD" },
      "revenue_estimate": { "amount": "108959817930.00", "currency_code": "USD" }
    },
    {
      "id": "record_ae13a8a4cc24cffb67f4",
      "company_id": "01M35H2KDW9VT69S5ZCEGMCPAX",
      "instruments": [
        { "instrument_id": "01M35H2KE2ZJHXFY5C3E7FPC66", "symbol": "XNAS:AAPL", "name": "Apple Inc." }
      ],
      "period_start": null,
      "period_end": "2026-09-30",
      "fiscal_year": 2026,
      "fiscal_quarter": 4,
      "period": "quarterly",
      "report_date": "2026-10-29",
      "report_at": null,
      "timing": "after_market",
      "status": "estimated",
      "eps_actual": null,
      "eps_estimate": { "amount": "1.98", "currency_code": "USD" },
      "eps_surprise": null,
      "eps_surprise_ratio": null,
      "revenue_actual": null,
      "revenue_estimate": { "amount": "113624521680.00", "currency_code": "USD" }
    }
  ],
  "meta": {
    "timezone": "UTC",
    "as_of": "2026-10-03T15:04:28Z",
    "next_cursor": null,
    "coverage": { "status": "partial", "reason": "Coverage is partial for the entitled query scope." }
  }
}