Skip to main content
GET
Get Earnings Calendar

Authorizations

Authorization
string
header
required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

FlowAuthorization Code
Authorization URL
https://app.aries.com/oauth2/authorize
Token URL
https://api.aries.com/v1/oauth2/token
Refresh URL
https://api.aries.com/v1/oauth2/token
FlowClient Credentials
Token URL
https://api.aries.com/v1/oauth2/token
Refresh URL
https://api.aries.com/v1/oauth2/token
Scopes1
calendar:information
Access earnings, economic, and market schedule data

Query Parameters

from
string<date>
required

Start date in YYYY-MM-DD format. Enter the first date to include in the research window.

Example:

"2024-01-01"

to
string<date>
required

End date in YYYY-MM-DD format. Enter the last date to include in the research window.

Example:

"2024-01-31"

symbol
string

Optional stock symbol to filter results. If not provided, returns earnings for all symbols.

Example:

"AAPL"

Response

Earnings calendar data retrieved successfully

analystRating
object

Analyst ratings summary

date
string

Earnings release date

epsActual
number | null

Actual earnings per share

epsEstimate
number | null

Estimated earnings per share

epsSurprise
number | null

Difference between actual and estimated EPS

hour
string

Time of day for earnings release: 'bmo' (before market open), 'amc' (after market close), 'dmh' (during market hours)

importance
integer

Earnings event importance level (1-3, where 3 is most important). Use this to filter and prioritize high-impact earnings releases.

Required range: 1 <= x <= 3

Company logos for UI display

marketCap
number | null

Market capitalization in millions. Calculated as: (1) cached value if available and > 0, or (2) lastPrice × sharesOutstanding. Only present if both inputs are available.

name
string

Company name

quarter
integer

Quarter number (1-4)

revenueActual
number | null

Actual revenue

revenueEstimate
number | null

Estimated revenue

revenueSurprise
number | null

Difference between actual and estimated revenue

symbol
string

Stock ticker symbol, such as AAPL. Use the exact ticker for the company you want to research.

time
string

Time of day for earnings release: '16:39:00' 24 hours format

year
integer

Year of the earnings