Skip to main content
GET
/
v1
/
calendars
/
earnings
Get Earnings Calendar
curl --request GET \
  --url https://api.tradearies.dev/v1/calendars/earnings \
  --header 'Authorization: Bearer <token>' \
  --header 'X-API-Key: <api-key>'
[
  {
    "date": "<string>",
    "epsActual": 123,
    "epsEstimate": 123,
    "hour": "<string>",
    "quarter": 123,
    "revenueActual": 123,
    "revenueEstimate": 123,
    "symbol": "<string>",
    "year": 123
  }
]

Authorizations

​
X-API-Key
string
header
required
​
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"

​
page
integer
default:0

Page number for pagination (starts from 0)

Required range: x >= 0
​
pageSize
integer
default:20

Number of results per page (max 1000)

Required range: 1 <= x <= 1000

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 (e.g., 'bmo' for before market open, 'amc' for after market close)

​
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