Calendar
Calendar API Reference
This REST API returns structured data for conference calls, dividends, earnings (and future earnings dates), economics, pharmaceutical announcements, guidance, IPOs, secondary offerings, ratings, M&A activity, and splits.
Best Practices
For optimal performance, we have a few recommendations.Limit query, improve performance
Limiting the scope of the query will directly improve the latency of the API. This can be accomplished by using parameters such asparameters[tickers] and parameters[date], or (preferably) by using parameters[updated] for deltas.
Using Deltas
A common pattern is to use a delta to query for the latest change in a dataset. By reducing the amount of data available in the query, it will produce results with the least amount of latency and limited data an application will have to traverse. In our case, we recommend tracking and querying by the latest updated timestamp. One caveat to allow for some latency and second-only timestamps: when querying, setparameters[updated] to a value 5 seconds earlier than you actually want. A query may look like:
/calendar/earnings?parameters[updated]=LAGGED_TIMESTAMP Where LAGGED_TIMESTAMP is set to be five seconds less than the maximum value of the updated field in rows already pulled from our API.
FAQs
How many data objects can I recieve in one response?
How many data objects can I recieve in one response?
The number of results returned is limted to 1000 items per page.
Can I request data for a particular company?
Can I request data for a particular company?
Yes, you can request one or more ticker symbols separated by a comma. Maximum of 50 ticker symbols can be passed in the request.
Authentication
The
token authentication