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_KEY

Code 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

symbolnextDatetimeepsEstimate
AAPL2026-05-07after-hours1.95
MSFT2026-04-28after-hours3.24

Build steps

  1. 1Start with the user's watchlist symbols.
  2. 2Call the earnings endpoint once per symbol.
  3. 3Pick the nearest future date and store it next to the symbol.

Quota and limits

Free tier includes 60 requests per minute, 100 requests per day, and 1,000 requests per month. Paid plans are built for production use with higher limits and a 300 requests per minute rate limit. Daily and monthly reset windows use New York time.

View usage