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%"
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

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

​
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, such as AAPL. Use the exact ticker for the company you want to research.

​
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