AlphaAI News

Search AlphaAI's enriched financial news feed. Filter by free-text query (tokens are AND-matched across title and summary), ticker symbols, category, date range, and minimum relevance score (1-10). Results are paginated with an opaque cursor. Set collapse_stories=true to get one row per story instead of every syndicated reprint, with a sources_count corroboration signal.

Latest news for a single ticker (e.g. 'AAPL'). Cursor-paginated; returns the same shape as alphai_news_search. Insider news (SEC Form 4 trades + 13F ownership moves) for the ticker is included by default — pass include_insider=false for a pure non-insider feed. Set collapse_stories=true to get one row per story instead of every syndicated reprint. Sets unknown_ticker=true when the symbol isn't a recognized active ticker.

Top news from the last 48h ranked by AI-assigned relevance. Use this when the user asks 'what's moving' / 'what's the big story'. Lower min_relevance to surface weaker movers. Syndicated reprints of one story are collapsed to a single representative by default (dedupe=false to keep all).

Breaking, decision-grade news from the last few hours. The primary filter is the enricher's actionability score, and the gate is strict: by default only actionability='high' (a concrete trading decision to act on TODAY — fresh guidance cut, halted trading, breaking M&A, surprise print) qualifies. Big-but-not-urgent stories scored 'medium' (shape a position over days/weeks) never appear at the default floor no matter how high their novelty — pass min_actionability='medium' to include them, or use alphai_trending / alphai_ticker_news for the broader tape. An empty list outside US market hours (nights, weekends) is expected — it means no high-actionability prints in the window, not an error; widen hours or min_actionability before concluding nothing happened. min_novelty is a secondary threshold that drops post-event recaps of already-public stories. Ordered novelty-first; syndicated reprints collapsed by story (dedupe=false to keep all).

Ownership-change news: SEC Form 4 insider trades (company officers, directors and 10% owners buying or selling their own stock) plus 13F institutional ownership moves (funds and foundations increasing or trimming stakes). Optionally filter by ticker and date range. Cursor-paginated; same shape as alphai_news_search. Roughly equivalent to alphai_news_search(category='insider'), exposed as a dedicated tool. Sets unknown_ticker=true when a ticker filter isn't a recognized active symbol.

Compare two tickers (e.g. NVDA and AMD). Returns news naming BOTH companies — where the cross-ticker read-across lives (a peer's print resetting the other's setup, a shared supplier/customer) — plus each ticker's own recent news for context. Any symbol that isn't a recognized active ticker is listed in unknown_tickers and contributes no rows.

Fetch a single article (with full enrichment: ticker analysis, context, key entities) by its uid. The full article body is intentionally not served (copyright) — this is the canonical single-article lookup, not a fuller view. Raises not_found for an unknown uid.

List supported stock and ETF tickers. Optionally filter by query (prefix on ticker, substring on name) or by sector.

List the caller's active ticker news-alert subscriptions, including per-subscription filters (category whitelist, minimum relevance score, delivery mode).

Subscribe the caller to ticker news alerts. Optional category_filter (e.g. ['earnings','insider']) restricts which categories trigger; min_relevance_score raises the threshold. This is a partial update: omitting either field on an existing subscription preserves its current value, and a brand-new subscription defaults min_relevance_score to 6. Raises tier_not_paid / unknown_ticker / limit_reached.

Soft-disable the caller's news-alert subscription for the given ticker. Idempotent — returns {removed: false} if the alert was already inactive. Raises unknown_ticker for an unrecognized symbol.