Example
Watchlist Earnings Monitor
Find the next earnings date for a portfolio or watchlist.
Request
GET https://api.earningsapi.com/v1/earnings?symbol=AAPL&apikey=YOUR_API_KEYCode example
ExamplePython
import requests
API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.earningsapi.com"
WATCHLIST = ["AAPL", "MSFT", "NVDA"]
def get_json(path):
response = requests.get(f"{BASE_URL}{path}", params={"apikey": API_KEY}, timeout=30)
response.raise_for_status()
return response.json()
for symbol in WATCHLIST:
data = get_json("/v1/earnings".replace("{symbol}", symbol) + ("?symbol=" + symbol if "{symbol}" not in "/v1/earnings" else ""))
print(symbol, data[:1] if isinstance(data, list) else data)Result shape
| symbol | nextDate | time | epsEstimate |
|---|---|---|---|
| AAPL | 2026-05-07 | after-hours | 1.95 |
| MSFT | 2026-04-28 | after-hours | 3.24 |
Build steps
- 1Start with the user's watchlist symbols.
- 2Call the earnings endpoint once per symbol.
- 3Pick the nearest future date and store it next to the symbol.