DocsAPI ReferenceDirectional TradingEarnings

Earnings

The stock-event calendar across the covered universe: earnings dates, dividends and splits.

Calendar

GET/earnings

Parameters

tickersstring

Comma-separated tickers. Default: the whole covered universe.

typestring

earnings (default), dividend (includes amount) or split.

from / todate

Bound by event date (YYYY-MM-DD).

limitnumber

Max events (default 200, cap 1000).

curl -H "Authorization: Bearer qw_live_YOUR_KEY" \
  "https://quantwheel.com/api/v1/earnings?from=2026-08-03&to=2026-08-07"

200 OK

{
  "type": "earnings",
  "count": 42,
  "total": 42,
  "events": [
    { "ticker": "AMD", "date": "2026-08-04", "type": "earnings" },
    { "ticker": "SMCI", "date": "2026-08-05", "type": "earnings" }
  ],
  "asOf": "2026-07-30T14:45:00.000Z"
}

Expected move & positioning: coming soon

Derived earnings analytics (expected move, dealer positioning into the print) are on the roadmap for this endpoint. Today it serves the raw calendar.

For wheel workflows, the screener already understands earnings: pass "includesEarnings": "no" to POST /screener to exclude contracts that span a report date, and every row carries an includesEarnings flag.

Flow

Historical Data