Skip to main content

​
GET /v1/market/earnings-calendar

Return upcoming and recent earnings events with consensus estimates, actuals, and surprise data
Audience: application and coding agent.

​
Query parameters

ParameterTypeDescription
date_fromstringRequired. Start date (YYYY-MM-DD)
date_tostringRequired. End date (YYYY-MM-DD)
symbolstringFilter to a single ticker symbol
limitintegerPage size (default 100, max 1000)

​
Canonical metadata

  • requestId
  • traceparent

​
Example request

curl -X GET \
  -H "x-api-key: $OMNI_DATASTREAM_API_KEY" \
  -H "omni-version: 2026-03-19" \
  "https://api.secapi.ai/v1/market/earnings-calendar?date_from=2026-03-24&date_to=2026-03-31&limit=5"

​
Example response

{
  "object": "list",
  "data": [
    {
      "object": "earnings_event",
      "symbol": "AAPL",
      "reportDate": "2026-03-27",
      "reportTime": "amc",
      "metric": "eps",
      "estimate": 2.35,
      "actual": 2.41,
      "surprisePercent": 2.55,
      "analystCount": 32,
      "fiscalPeriod": "Q1",
      "fiscalYear": 2026
    },
    {
      "object": "earnings_event",
      "symbol": "AAPL",
      "reportDate": "2026-03-27",
      "reportTime": "amc",
      "metric": "revenue",
      "estimate": 94500000000,
      "actual": 95200000000,
      "surprisePercent": 0.74,
      "analystCount": 28,
      "fiscalPeriod": "Q1",
      "fiscalYear": 2026
    }
  ],
  "hasMore": false,
  "nextCursor": null,
  "configured": true,
  "requestId": "req_example_456",
  "traceparent": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

​
Give this prompt to your agent

​
Failure posture

  • treat non-2xx responses as contract-aware failures, not free-form errors
  • preserve requestId and traceparent in logs and downstream reports
  • date_from and date_to are required; omitting either returns a 400