Skip to main content
Earnings endpoints return quarterly/annual earnings results with consensus, actuals, surprises, and the synthetic press release, plus a forward-looking earnings calendar.

​
Earnings

GET /earnings
Earnings results for a ticker (or across the scenario when ticker is omitted).
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringNoallRestrict to one ticker.
limitintegerNo4Page size (max 100).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/earnings?scenario_id=<id>&ticker=AAPL" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "earnings": [
    {
      "ticker": "AAPL",
      "report_period": "2026-03-31",
      "filing_date": "2026-04-24",
      "accession_number": "0000320193-26-000018",
      "fiscal_period": "Q1",
      "currency": "USD",
      "filing_datetime": "2026-04-24T16:30:00",
      "signals": { "revenue_surprise": 0.021, "eps_surprise": -0.014, "guidance": "cut" },
      "press_release": "Apple today announced financial results ...",
      "quarterly": { "revenue": 124300000000, "eps": 2.18, "...": "..." },
      "annual": { "...": "..." }
    }
  ]
}
The signals block carries the revenue and EPS surprise and the guidance direction. News and filings repeat these same numbers. See Synthetic data.

​
Earnings calendar

GET /earnings/calendar
Upcoming/known earnings dates for a ticker.
ParameterTypeRequiredDefaultDescription
scenario_idstringYes-The world to read from.
tickerstringYes-Ticker symbol to query.
limitintegerNo20Page size (max 100).
offsetintegerNo0Pagination offset.
curl -s "https://api.davidhf.com/earnings/calendar?scenario_id=<id>&ticker=AAPL" \
  -H "X-API-KEY: YOUR_API_KEY"

{
  "earnings_calendar": [
    {
      "ticker": "AAPL",
      "report_period": "2026-03-31",
      "fiscal_period": "Q1",
      "earnings_date": "2026-04-24",
      "filing_datetime": "2026-04-24T16:30:00"
    }
  ]
}

​
Discovery helper

GET /earnings/tickers
Takes only scenario_id; returns tickers with earnings. 
{ "tickers": ["AAPL", "MSFT", "..."] }