Get Earnings Intelligence
get_earnings_intelligenceUpcoming earnings with AI context - AI scores, verdicts, and risk factors per stock. Combines the earnings calendar with AI pipeline data to surface which upcoming earnings events are worth monitoring.
Parameters:
days_ahead: look-ahead window in days (default 14, max 30)
sector: filter to one sector (e.g. "Technology")
min_ai_score: only return stocks with AI score >= this value, 0-100 (optional). Gates on the same ai_score field the response returns. Applied server-side before
limittruncates the result - a stock with a qualifying score always counts againstlimitahead of one without, rather than being cut off first for reporting later in the earnings window.limit: max results to return (default 25, max 25). Each returned ticker counts as one call toward your daily limit - see the docs' rate-limit section.
Returns per stock (sorted by earnings_date ascending):
earnings_date: ISO UTC timestamp · is_estimate: whether date is estimated
symbol, name, sector, price, rsi, market_cap
eps_trailing, eps_forward (earnings expectations context)
ai_verdict (positive/neutral/negative, from nightly AI pipeline)
ai_score (0-100) / ai_score_band (Weak/Moderate/Strong/Very Strong) - the AI research composite score, same 0-100 scale and bands as signal_score but a separate score; null if this stock has no AI summary yet.
ai_risks: top 2 AI-identified risk factors
analyst_rating, analyst_target
Pro tier only - AI pipeline cost attached. For informational purposes only. Not financial advice.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results to return (default 25, max 25). Each returned ticker counts as one call toward your daily limit. | |
| sector | No | Filter to one sector, e.g. "Technology". | |
| days_ahead | No | Look-ahead window in days (default 14, max 30). | |
| min_ai_score | No | Only return stocks with AI score >= this value, 0-100 (optional). Gates on the same ai_score field the response returns. Applied server-side before limit truncates the result, so a qualifying stock always counts against limit ahead of one without. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||