工具 API

get_upcoming_dividends

Get historical and upcoming dividend calendar dates for stocks. Calendar records contain only the dividend date and ticker symbol; this endpoint does not return dividend amounts, currency, declaration dates, record dates, or payment dates. Requires at least one of 'symbol' or 'date_eq'. Supports date range filtering and pagination. Use when the user asks about dividend dates or ex-dividend calendars. For dividend amounts, currencies, payout history, or other dividend details for a ticker, use get_historical_dividends. For IPO calendar, use get_upcoming_ipos. For stock splits calendar, use get_upcoming_splits. Returns: An object containing: - meta (object): total, limit, and offset pagination metadata, plus filter echoes when present - data (array): dividend calendar records, each with only: - date (str): dividend date in YYYY-MM-DD format - symbol (str): ticker in EODHD format - links (object): pagination links, including next (str | null) Examples: "Apple dividends in 2025" → symbol="AAPL.US", date_from="2025-01-01", date_to="2025-12-31" "All dividends on March 15" → date_eq="2026-03-15" "Microsoft dividends this quarter" → symbol="MSFT.US", date_from="2026-01-01", date_to="2026-03-31" 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.