curl --request GET \
--url https://api.aries.com/v1/calendars/earnings \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v1/calendars/earnings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/calendars/earnings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/calendars/earnings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/calendars/earnings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/calendars/earnings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/calendars/earnings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"analystRating": {
"averageReturn": "15.3%",
"currentRating": "Buy",
"priceTarget": 200.5,
"successRate": "72%",
"totalRatings": 45
},
"date": "2024-01-16",
"epsActual": 2.18,
"epsEstimate": 2.1,
"epsSurprise": 0.08,
"hour": "amc",
"importance": 3,
"logo": {
"logoDark": "https://example.com/aapl-dark.png",
"logoLight": "https://example.com/aapl-light.png"
},
"marketCap": 2850000,
"name": "Apple Inc.",
"quarter": 1,
"revenueActual": 119580000000,
"revenueEstimate": 118000000000,
"revenueSurprise": 1580000000,
"symbol": "AAPL",
"time": "06:45:00",
"year": 2024
}
]Earnings Calendar
Retrieve upcoming and historical earnings announcement dates, expected EPS, revenue estimates, and confirmed reporting times. Filter by date range or specific symbols to track quarterly earnings releases and plan trades around volatility events.
Use Case: Alert users 24 hours before their portfolio holdings report earnings to manage position risk.
curl --request GET \
--url https://api.aries.com/v1/calendars/earnings \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aries.com/v1/calendars/earnings"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/calendars/earnings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aries.com/v1/calendars/earnings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aries.com/v1/calendars/earnings"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aries.com/v1/calendars/earnings")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/calendars/earnings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body[
{
"analystRating": {
"averageReturn": "15.3%",
"currentRating": "Buy",
"priceTarget": 200.5,
"successRate": "72%",
"totalRatings": 45
},
"date": "2024-01-16",
"epsActual": 2.18,
"epsEstimate": 2.1,
"epsSurprise": 0.08,
"hour": "amc",
"importance": 3,
"logo": {
"logoDark": "https://example.com/aapl-dark.png",
"logoLight": "https://example.com/aapl-light.png"
},
"marketCap": 2850000,
"name": "Apple Inc.",
"quarter": 1,
"revenueActual": 119580000000,
"revenueEstimate": 118000000000,
"revenueSurprise": 1580000000,
"symbol": "AAPL",
"time": "06:45:00",
"year": 2024
}
]Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
- 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
- Token URL
- https://api.aries.com/v1/oauth2/token
- Refresh URL
- https://api.aries.com/v1/oauth2/token
Query Parameters
Start date in YYYY-MM-DD format. Enter the first date to include in the research window.
"2024-01-01"
End date in YYYY-MM-DD format. Enter the last date to include in the research window.
"2024-01-31"
Optional stock symbol to filter results. If not provided, returns earnings for all symbols.
"AAPL"
Response
Earnings calendar data retrieved successfully
Analyst ratings summary
Show child attributes
Show child attributes
Earnings release date
Actual earnings per share
Estimated earnings per share
Difference between actual and estimated EPS
Time of day for earnings release: 'bmo' (before market open), 'amc' (after market close), 'dmh' (during market hours)
Earnings event importance level (1-3, where 3 is most important). Use this to filter and prioritize high-impact earnings releases.
1 <= x <= 3Company logos for UI display
Show child attributes
Show child attributes
Market capitalization in millions. Calculated as: (1) cached value if available and > 0, or (2) lastPrice × sharesOutstanding. Only present if both inputs are available.
Company name
Quarter number (1-4)
Actual revenue
Estimated revenue
Difference between actual and estimated revenue
Stock ticker symbol, such as AAPL. Use the exact ticker for the company you want to research.
Time of day for earnings release: '16:39:00' 24 hours format
Year of the earnings
Was this page helpful?