Financial calendar
Build market-wide or per-ticker earnings calendars from one dated event feed. Each event identifies the exact listing and fiscal period, then adds the release session, consensus estimates, reported results, and surprises as they become available.
Choose a calendar workflow
Start from the question your application needs to answer.
| Goal | Endpoint and approach |
|---|---|
| Find companies reporting in a date range | List earnings calendar events with date.gte and date.lt. |
| Show one ticker's schedule and history | Pass its identifier and choose ascending or descending order. |
| Check one release date | Use the exact date filter. |
| Continue through a large result set | Follow the returned cursor page URL unchanged. |
Work with earnings events
Events are recorded per ticker, with one event for each fiscal period. Use an
exchange-qualified identifier when the local ticker code is ambiguous. The
response symbol identifies the listing associated with the event.
Upcoming events can contain a release date, session, and EPS or revenue estimates. Reported events can also contain actual values and calculated surprises. Treat unavailable values as missing data instead of assuming zero.
To move from an event to management commentary, find the corresponding call in
the earnings-call list, then retrieve its full
transcript by stable ecall_ ID.
Common use cases
Use the calendar feed for applications that organize research around company reporting dates.
- Weekly earnings calendars. Build a weekly view of companies scheduled to report, sorted by release date and session, so users can plan research before or after each announcement.
- Portfolio event tracking. Add upcoming earnings events to portfolio and watchlist views so users can see which holdings report next.
- Estimate-versus-actual analysis. Compare consensus EPS and revenue estimates with reported actuals to show where results exceeded or missed expectations.
- Surprise monitoring. Flag positive and negative earnings surprises so analysts can prioritize companies that need follow-up research.
- Post-earnings research. Join reported events with earnings-call transcripts and daily stock prices to review management commentary and the market response together.
Plan access
The earnings calendar requires an Individual or higher plan. On the Individual plan, the available historical range is capped. Requests outside your plan's range return the standard permission error described in handle API responses.
Next steps
Use these pages to implement the calendar workflow.
- List earnings calendar events.
- List earnings calls after a company reports.
- Retrieve an earnings-call transcript.
- Handle pagination and API errors.