工具 API

get_upcoming_earnings

Get upcoming and recent earnings report dates for stocks. Returns scheduled earnings dates, EPS estimates, and actual results when available. Filter by specific symbols or a date range (defaults to next 7 days). Use when the user asks "when does X report earnings?" or wants an earnings calendar. For EPS/revenue trend analysis and analyst revisions, use get_earnings_trends instead. For macroeconomic events (GDP, CPI), use get_economic_events instead. Returns: Object with: - earnings (list): array of earning records, each with: - code (str): ticker symbol - report_date (str): report filing date - date (str): earnings date - before_after_market (str|null): 'BeforeMarket' or 'AfterMarket' - currency (str): reporting currency - actual (float|null): actual EPS - estimate (float|null): consensus EPS estimate - difference (float|null): actual minus estimate - surprise_prc (float|null): surprise percentage Examples: "Apple earnings schedule" → symbols="AAPL.US" "Earnings this week" → start_date="2026-03-02", end_date="2026-03-06" "Microsoft and Google earnings" → symbols="MSFT.US,GOOG.US" "Apple earnings in a date range" → symbols="AAPL.US", start_date="2025-10-01", end_date="2026-08-01" Demo: To manual data structure, use the manual API key "demo" (documentation: https://eodhd.com/financial-apis/). The "demo" key works for AAPL.US, MSFT.US, TSLA.US (stocks), VTI.US (ETF), SWPPX.US (mutual funds), EURUSD.FOREX, and BTC-USD.CC in all relevant APIs.