Endpoint
https://api.llmquant.com/events/earnings
Parameters
Required
The stock ticker symbol (e.g. AAPL).
Optional
Maximum number of events to return.
Filter events on or after this date (YYYY-MM-DD).
Filter events on or before this date (YYYY-MM-DD).
Response
Array of EarningsEvent objects, sorted by date descending.
Date of the earnings report (YYYY-MM-DD).
Fiscal period label (e.g. Q1 2024, FY 2024).
When results are released. One of: before_market, after_market, during_market.
Reported EPS (null if not yet reported).
EPS surprise (eps_actual - eps_estimate).
EPS surprise as a percentage.
Analyst revenue estimate.
Reported revenue (null if not yet reported).
Revenue surprise as a percentage.
Code Examples
import requests
headers = {"X-API-KEY": "your_api_key_here"}
url = "https://api.llmquant.com/events/earnings?ticker=AAPL&limit=8"
response = requests.get(url, headers=headers)
earnings = response.json().get("earnings")
for e in earnings:
print(f"{e['fiscal_period']}: EPS {e['eps_actual']} vs est {e['eps_estimate']}")