AlphAI

Market-wide central-bank, inflation/jobs, commodity and geopolitical news, ranked novelty-first. Macro stories often have no tickers. Filter categories or min_relevance; dedupe=false keeps reprints, otherwise items carry story_id and distinct-source counts. result contains stories; releases contains scheduled US releases in the same window and the next 24h, with coverage. For 'did the jobs report come out', inspect releases first. Elapsed with empty coverage means stories have not arrived yet: poll later, and check schedule_status for postponements. Use alphai_calendar for future dates beyond 24h. AI-generated context, not investment advice. Use detail='compact' for headlines, sources, times, tickers, scores and story/search metadata without summary, analysis or SEC detail blocks. Expand uids with alphai_article. detail='full' is default; selection, order, cursors and page metadata are identical.

alphai_macro

Summarize the caller's saved AlphAI watchlist in one read. Returns recent news grouped by story, a separate SEC filings section and the next confirmed earnings dates. Manage tickers at https://alphai.io/account/watchlist. Each story names the watched tickers it affects, carries a short summary and links to the article and its original source. Windows use article publication timestamps, not ingestion time; this is a ranked snapshot, not a changes cursor. Events and filings each contain up to limit items, with explicit truncation flags when more exist. Each section groups the newest 500 matching articles, then ranks by relevance, novelty and recency. Narrow hours or open the ticker feed when a section is truncated. Unknown tickers are listed separately. An empty tickers list means the caller has not saved a watchlist. A missing earnings date means no confirmed date is held, not that the company will not report. Available on every tier.

alphai_watchlist_brief

Rank news activity across the market or your saved AlphAI watchlist. Returns total story counts, model counts versus market-adjusted expectations, news tone and linked supporting headlines. Default: 20 tickers, 24h window, highest activity first. Use sentiment=negative or sort=sentiment_change with order=asc to find deteriorating news tone. Exact tickers intersect the selected scope; no alias expansion. Plans change added delay: Free 60 minutes, Basic 15 minutes, Pro none. Read as_of and freshness before describing recency; historical_preview means a fixed historical dataset, never a live reading. Only tickers with news in the chosen window appear. Missing metrics are null with a reason, not neutral. Scores describe observed news, not price forecasts or confirmed alerts. Follow next_cursor with identical filters and limit to keep the same snapshot; restart without cursor after snapshot_expired. Open a news evidence uid with alphai_article for the full enriched article. event_context adds separate issuer-CIK observations: 7-day 8-K/selected earnings 6-K filings and 30-day open-market insider clusters by latest SEC filing time, with sec_url links. For filings with has_article=true, open news_uid with alphai_article; news_title and news_published build its AlphAI URL. Article availability is frozen at the context cutoff; older snapshots default to false with null title/publication metadata. Read top-level event_context status/as_of and each row's event_context status before using counts. Null means unavailable, not zero; available does not certify complete SEC coverage. Context follows the same snapshot delay and cursors. It does not change news scores or row eligibility.

alphai_radar

ChatGPT connector contract: search AlphAI's AI-enriched financial news with a natural-language query. Ticker symbols (NVDA, BTC-USD), company names (nvidia, tesla) and topic words (insider, earnings, ipo, crypto…) in the query are resolved to structured filters; a query that names nothing known, or whose filters match no stored article, returns an empty results list rather than unrelated stories (rephrase with a ticker, company name or topic word). Each result carries an id for the fetch tool. For precise filtered queries prefer alphai_news_search.

search

Stories: market events that two or more publishers reported, each summarised by AlphAI from its articles. list=top (default) ranks the last 48 hours — importance (the feed's 1-10 scale, 7 and above) plus a coverage bonus, minus one point per 12 hours since the facts last changed, one slot per ticker — use it for 'what matters today'. list=latest pages every story newest-first by its latest article; follow next_cursor. Each card carries story_id, the summary's title and lead, importance, publishers, materials (articles) and summary_state (published / stale = new articles since the summary / preparing = no summary yet, texts are the lead article's). Call alphai_story with a story_id for the full summary — key facts with their sources, why it matters, the per-ticker read, open questions — and the articles behind it. Compared with alphai_trending, which ranks single articles, this ranks events and only those with independent coverage; most feed items are carried by one outlet and never become a story. Summaries are AI-generated financial information for research, not investment advice.

alphai_stories

One story by story_id — the value every news item carries, or an id from alphai_stories. Returns the summary AlphAI wrote from the articles (title, lead, why_it_matters, up to six key_facts each with the publisher and the source_uid of the article it was read from, ticker_takes with a direction per ticker, uncertainties the sources leave open), the story's importance and publisher count, and the first page of its articles (materials: uid, publisher, time, URL, relevance) — open any of them with alphai_article. status tells you what the id is: found (a story), merged (folded into another story; call again with redirect_to), not_a_story (one publisher carried this event, so there is no summary; article names the row for alphai_article — the normal answer for most feed items). summary_state published / stale (new_materials articles joined since the summary; AlphAI rewrites it on its own schedule, this call changes nothing) / preparing (no summary yet; texts are the lead article's). Every figure in the summary appears in a source article; it is AI-generated financial information for research, not investment advice. Article bodies are never returned.

alphai_story

WRITE operation (creates/updates a saved subscription in the caller's account). 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 7. Note the threshold applies to email and telegram delivery; a Pro webhook receives the full matched stream and filters on its own. Raises tier_not_paid / unknown_ticker / limit_reached. Crypto alerts use the <SYM>-USD ticker (BTC-USD); subscribing to a collider string like BTC binds the stock/ETF that owns it and the response's note field says so. OAuth connections need the alerts.write scope (raises insufficient_scope otherwise); API keys have it.

alphai_alerts_subscribe

News for one ticker, including SEC Form 4 trades by default. Use include_insider=false to omit those trades. Published mode serves older history; ingested mode polls new arrivals. collapse_stories=true selects story roots, not later member updates. Delisted symbols retain history with delisted/renamed_to metadata; unknown_ticker means unrecognized. Rename aliases and issuer share classes are included. Coins use <SYM>-USD; ticker_note flags stock/ETF collisions. Use detail='compact' for headlines, sources, times, tickers, scores and story/search metadata without summary, analysis or SEC detail blocks. Expand uids with alphai_article. detail='full' is default; selection, order, cursors and page metadata are identical. In ingested mode, prime may be partial/empty and starts at the feed head. Resume until empty success; short pages can continue. Errors are JSON: delta_scan_incomplete means use extra.next_cursor with unchanged filters/sort; delta_candidates_changed means retry the original request.

alphai_ticker_news

Top news from the last 48h ranked by AI-assigned relevance decayed by article age (fresh stories lead; at most two stories per ticker, and market-wide macro stories — Fed/CPI, commodities, geopolitics, carrying no tickers — capped per category). Use this when the user asks 'what's moving' / 'what's the big story'. Lower min_relevance to surface weaker movers. By default each item carries the full AI analysis inline — no follow-up alphai_article call needed for depth. Syndicated reprints of one story are collapsed to a single representative by default (dedupe=false to keep all), and each item reports story_id (the story root's uid — a stable story key, the same value the other news tools report for that story), sources_count and sources. Most stories run at a single outlet, so sources_count is usually 1; a value above 1 is the signal, not the number itself. Use detail='compact' for headlines, sources, times, tickers, scores and story/search metadata without summary, analysis or SEC detail blocks. Expand uids with alphai_article. detail='full' is default; selection, order, cursors and page metadata are identical.

alphai_trending

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. The two recent lists are condensed (headline + scalar signals; the full analysis is on BOTH — fetch alphai_article(uid) for a recent item's full write-up). Pair analysis covers active tickers only: any symbol that isn't a recognized active ticker is listed in unknown_tickers and contributes no rows (delisted-symbol history lives in alphai_ticker_news). Informational and AI-generated — not investment advice. Use detail='compact' for headlines, sources, times, tickers, scores and story/search metadata without summary, analysis or SEC detail blocks. Expand uids with alphai_article. detail='full' is default; selection, order, cursors and page metadata are identical.

alphai_pair_analysis

WRITE operation (deactivates a saved subscription in the caller's account). 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. OAuth connections need the alerts.write scope (raises insufficient_scope otherwise); API keys have it.

alphai_alerts_unsubscribe