Skip to main content
GET
/
v1
/
calendars
/
earnings
Get Earnings Calendar
curl --request GET \
  --url https://api.aries.com/v1/calendars/earnings \
  --header 'Authorization: Bearer <token>'
[
  {
    "date": "2024-01-16",
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "hour": "amc",
    "quarter": 1,
    "year": 2024,
    "epsActual": 2.18,
    "epsEstimate": 2.1,
    "epsSurprise": 0.08,
    "revenueActual": 119580000000,
    "revenueEstimate": 118000000000,
    "revenueSurprise": 1580000000,
    "marketCap": 2850000,
    "logo": {
      "logoLight": "https://example.com/aapl-light.png",
      "logoDark": "https://example.com/aapl-dark.png"
    },
    "analystRating": {
      "currentRating": "Buy",
      "priceTarget": 200.5,
      "totalRatings": 45,
      "successRate": "72%",
      "averageReturn": "15.3%"
    }
  }
]

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

from
string<date>
required

Start date in YYYY-MM-DD format

Example:

"2024-01-01"

to
string<date>
required

End date in YYYY-MM-DD format

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

date
string

Earnings release date

epsActual
number | null

Actual earnings per share

epsEstimate
number | null

Estimated earnings per share

hour
string

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

quarter
integer

Quarter number (1-4)

revenueActual
number | null

Actual revenue

revenueEstimate
number | null

Estimated revenue

symbol
string

Stock ticker symbol

year
integer

Year of the earnings

name
string

Company name

epsSurprise
number | null

Difference between actual and estimated EPS

revenueSurprise
number | null

Difference between actual and estimated revenue

marketCap
number | null

Market capitalization in millions

Company logos for UI display

analystRating
object

Analyst ratings summary