AlphAIalphai — Financial news for AI agents
Changelog

What changed.

User-visible changes to the REST API, the MCP server, and the data pipeline — newest first. If it affects what your bot receives, it's here.

REST docs · MCP docs · OpenAPI spec

August 13, 2026
APIMCP

Insider feed: 10b5-1 filter, joint-filing names

  • GET /api/news/insider/?is_10b5_1=false returns the discretionary trades and drops the sales that ran on a Rule 10b5-1 plan set up months earlier. Pass true for the plan events alone, or omit the parameter for the feed as before. The same filter is on alphai_insider_news in MCP, and it composes with symbol=, min_relevance= and sort=ingested delta polling.
  • It filters on the same field each item already reports, at the same level. An event is the whole transaction group of a filing, so a filing that mixes a plan tranche with a discretionary one counts as a plan event on both the filter and the insider.is_10b5_1 field. The two values split the feed with nothing left over: every event the unfiltered feed returns comes back under exactly one of them.
  • Joint Form 4 filings now name every reporting owner. When a holding vehicle files together with the person behind it, the headline carries both (“BERKSHIRE HATHAWAY INC (BUFFETT WARREN E) sold $36.5M of DVA”), the summary lists each co-filer with their role, and the authors array holds all owners, primary first. About one in five of the largest filings is a joint one, so the names most worth watching were exactly the ones the feed used to drop. Applies to filings ingested from today onward.
  • Full parameter reference is in the OpenAPI 1.25.0 spec.
August 11, 2026
Platform

alphai-tui 0.13.0: the insider trades chart, in the terminal

  • The Insider view of alphai-tui now draws the same chart as our insider trades pages: every Form 4 event as a triangle on a log dollar scale, buys and sells apart, hollow marks for sales to the issuer, 10b5-1 plan trades dimmed, with weekly dollar bars underneath. The g key cycles the window between 3 months, 12 months and off.
  • The chart reads the /api/symbols/{ticker}/insider-trades/ endpoint documented today, riding the same request the view already made, so the free tier budget is untouched. Selecting a filing in the list highlights its mark on the chart, and the detail pane picks up the stake share the event moved and its tranche count.
  • Update with brew upgrade alphai-tui, cargo install alphai-tui, apt or AUR; prebuilt binaries are on the releases page.
August 11, 2026
APIDocs

Per-ticker insider trades endpoint

  • GET /api/symbols/{ticker}/insider-trades/ serves the complete Form 4 event history for one ticker, built for charts. The first page carries 3-month, 12-month and all-time rollups, the most active insiders, weekly and monthly dollar buckets, and chart_events: every event of the trailing 12 months in one array. Deeper history pages with cursor=. This is the payload behind our own insider trades pages, now part of the documented contract in the OpenAPI 1.24.0 spec.
  • Each event extends the feed's insider block with stake_change_pct (the share of the position the event moved, sells negative), tranche_count, security_title and a news_uid link to the enriched article. One semantic difference: side follows the value flow here, so a code D sale to the issuer counts as sell, and transaction_code tells the two apart.
  • page_size= accepts up to 200 on every tier, so one request loads a chart's whole working set. The aggregates always cover both sides regardless of the side= filter.
August 6, 2026
APIMCPPlatform

Form 4 coverage gap: fixed and backfilled

  • Between early June and August 5 our SEC Form 4 collector missed a share of filings, so insider items were incomplete in /api/news/, /api/news/insider/, the alphai_insider_news MCP tool, per-ticker insider summaries and alerts. The collector was fixed on August 6.
  • Every recoverable filing was backfilled the same day from SEC's daily indexes (1,489 filings). Historical insider queries now return the full set. If you poll with sort=ingested, the restored rows arrived on August 6 carrying their original time_published.
  • The weekly Insider Radar issues on /research for the affected weeks were restated with the corrected figures. Each restated issue says so in its methodology note.
  • Coverage is now verified daily against SEC's own filing index, independent of our pipeline.
August 5, 2026
APIMCP

Company lookups match brand names

  • A free-text query on alphai_news_search now resolves the name a company is known by, not only the name it is registered under. query="spacex" returns SPCX news, though the symbol is registered as SPACE EXPLORATION TECHNOLOGIES CORP. The search tool that deep-research clients call reads the same way.
  • alphai_tickers and GET /api/symbols/?search= match brand names too, so you can go from a name a user typed to a canonical ticker in one call. Brand hits rank with exact ticker and exact name matches, above prefix and substring ones. See the updated OpenAPI spec (1.22.0).
  • A company name in query now resolves to the issuer rather than to one of its listings, so query="google" returns the Alphabet stories tagged GOOG as well as those tagged GOOGL. That matches how the per-ticker tools have always treated a symbol. An explicit tickers filter is unchanged and still means exactly the symbols you list.
  • A word that fits more than one active company still resolves to no ticker instead of a guess, and an unresolved query returns the general feed. When you already know the symbol, pass tickers rather than free text, and you get an exact filter every time.
July 31, 2026
APIMCP

Economic calendar: scheduled US macro releases

  • GET /api/calendar/ lists the official schedule of US macro releases: FOMC decisions and minutes, CPI, PPI, the jobs report, GDP estimates, PCE, retail sales, weekly jobless claims and JOLTS, taken from official agency schedules. The default window is the next 7 days. from_date and to_date take a date or an ISO datetime, event_key narrows to specific series, importance filters by tier. Spec: OpenAPI 1.21.0.
  • Each occurrence has a stable uid like US-CPI-2026-07 that survives reschedules: a moved release keeps its identity and updates scheduled_at and schedule_status. The computed phase field says whether the scheduled moment has passed (upcoming or elapsed); it deliberately does not claim the agency has published, so a postponed release reads as postponed, not missing. schedule_basis tells you where each date came from: official means it is printed on the agency schedule, inferred means it follows the documented release cadence (weekly jobless claims, FOMC minutes the Fed has not dated yet). FOMC rows carry press_conference_at and has_sep for the projection meetings.
  • The alphai_calendar MCP tool serves the same calendar with one addition: elapsed occurrences include coverage, the top feed stories about that release with their uids and relevance scores, ready to expand via alphai_article. Coverage applies only to releases that actually happened: a cancelled or postponed occurrence returns coverage: null. Ask it what is coming this week, then read alphai_macro for what a release meant once it is out.
July 30, 2026
APIMCP

Macro coverage: Fed decisions, CPI and jobs prints, commodities, geopolitics

  • Market-wide macro news is now in the feed. Rows in the macro_economy, commodities and geopolitics categories carry an empty tickers list, because an FOMC statement is not news about one company. They appear in /api/news/, in alphai_news_search, in trending and in the actionable feed. Filter them by category rather than by symbol.
  • A dedicated GET /api/news/macro/ endpoint and an alphai_macro MCP tool serve the macro tape in one call: central-bank decisions, inflation and jobs prints, oil and gold, geopolitical risk. The REST endpoint returns newest first, with sort=ingested for delta polling; the MCP tool ranks by information novelty, so on a release day the release itself leads and the reaction pieces follow. Free-text queries with words like “fed”, “fomc” or “cpi” now resolve to the macro category. Spec: OpenAPI 1.20.0.
  • Scoring: a scheduled market-wide release scores 7-9 on its release day (8-9 when it surprises consensus or carries a policy shift), so min_relevance=7 keeps the events and drops most of the commentary. Previews and post-release reaction pieces keep their lower scores.
July 30, 2026
APIMCP

Event-level story grouping

  • Story grouping now matches articles by meaning, not only by headline overlap. Two outlets writing up the same event in their own words (“J&J reaches $5.5bn talc deal” and “Johnson & Johnson offers $5.5 billion to settle”) land in one story with both sources attached.
  • Every story surface benefits: ?collapse=story on /api/news/, collapse_stories=true on the MCP news tools, and the trending feeds, which collapse by default. Expect fewer duplicate rows per event and sources_count above 1 more often. Most stories still run at a single outlet.
  • No contract changes: same parameters, same fields, and the default uncollapsed feed still returns every article. Grouping is deliberately conservative, so two genuinely different takes on a ticker stay separate rows.
July 29, 2026
APIMCP

Validated insider transaction values

  • Dollar values on SEC Form 4 insider items are now validated against the instrument's own recent filing history before they reach the feed. A filing that carries the lot total, or a decimal-shifted number, in its price-per-share field is corrected back to the true per-share price. When nothing corroborates a correction, the dollar value is omitted rather than guessed and the item keeps its share count. This covers avg_price_usd and total_value_usd in the insider block, the amounts in titles and summaries, and the value-driven relevance_score on insider items.
  • 28 historical insider items published between May 28 and July 28, 2026 now serve corrected figures and scores. Their uids are unchanged. If you store insider events, re-fetch that window on GET /api/news/insider/ or alphai_insider_news to pick up the corrections.
July 28, 2026
APIMCP

Pro archive depth is now 180 days

  • The Pro news archive on the REST API and MCP is now 180 days deep instead of unlimited. Free stays at 30 days and Basic at 90. Paging past your horizon on GET /api/news/ or GET /api/news/insider/ returns 403 with extra.reason: archive_horizon and your plan's archive_days, exactly as before. MCP news tools apply the same window as a search cutoff.
  • An honest note on what the archive holds: our collectors expanded in June 2026, so months before that carry fewer articles per day than the current feed. The paging depth is the same for every plan surface, the per-day density before June 2026 is not. The OpenAPI spec now says the same.
  • If your use case needs history deeper than 180 days, tell us through the contact form. A dedicated deep-history plan is in the works, and early requests shape what it guarantees.
July 27, 2026
APIPlatform

One event, one alert

  • When several outlets carry the same story, alerts no longer fire once per outlet. Each ticker subscription now receives a single delivery per story per channel within a 24-hour window, on email, Telegram and Pro webhooks. The daily digest follows the same rule, so one event takes one line instead of five.
  • For webhook consumers this changes what arrives on news.matched.v1. If you collapse near-duplicate articles yourself before acting on them, that layer is now mostly redundant. Articles still carry their own uid and you can still fetch any of them from GET /api/news/<uid>/; what changed is how many of them we push at you for one event.
  • Telegram alerts also picked up the per-ticker cooldown that email alerts have always had. A ticker in the middle of a heavy news cycle paces its messages now rather than sending one per article.
  • Nothing to configure and no change to how alerts are created. Manage them in your account or through the alphai_alerts_* MCP tools as before.
July 26, 2026
Platform

A public status page

  • Availability is now public at status.alphai.io. Four endpoints are watched around the clock: the website, the REST API, the authentication gate on api.alphai.io, and the MCP server. The page keeps response times and uptime for each of them, and every incident is filed publicly as it happens.
  • The REST API check is a readiness check, not a ping. It passes only when the database and the cache both answer, so a green REST API on that page means your requests can actually be served.
  • The monitor runs outside our own infrastructure and the page is hosted away from it, so when our stack has a bad day the status page stays reachable and reports it. The 30-day numbers also sit on the API page and the MCP page.
July 26, 2026
APIMCP

Delta polling on the insider feed, story sources on trending, symbol locale

  • The insider feed polls like the main feed. GET /api/news/insider/?sort=ingested and alphai_insider_news with sort="ingested" return Form 4 events in the order they became available, under the same cursor contract as the main feed: next_cursor is always present, and an empty page means you are caught up. Reach for this mode when you are watching insider activity. A Form 4 is filed days after the trade it reports, so a new event often enters the feed below the newest page, where a poller that only re-reads the first page never sees it.
  • Trending items now carry the story fields. GET /api/news/trending/ and alphai_trending collapse syndicated reprints to one representative, and each item reports the story it stands for: story_id, sources_count (distinct outlets covering it) and sources (their domains). Two pieces from the same outlet count once, so the number counts outlets and not articles. Most stories run at a single outlet, so expect 1 on the majority of items and treat anything higher as the signal. On MCP the fields appear when dedupe is on, which is the default; with dedupe=false nothing is collapsed and they stay null.
  • country and currency are populated across the symbol universe. US listings report US and USD, foreign listings their venue and local currency, crypto pairs USD with an empty country since a coin has no domicile. Visible on GET /api/symbols/, GET /api/symbols/{ticker}/ and alphai_tickers.
  • Free-text search resolves an asset by name, not just by symbol. Asking search or alphai_news_search for "bitcoin" returns BTC-USD coverage instead of the whole crypto category, and the same holds for other names that collide with a family of tickers. Topic words like "crypto", "earnings" and "insider" still resolve to their category.
  • Insider events report when the filing landed. The insider block on GET /api/news/insider/ and alphai_insider_news adds filed_at, the moment EDGAR accepted the Form 4, and late_filing, true when the filing missed the SEC's two business day deadline. Roughly 3% of events carry the flag, and the tail is catch-up filings covering trades from years earlier. Dates are compared in Eastern time with one weekday of slack, so a trade in a holiday week is not flagged.
  • The spec is at /api/schema/, version 1.17.0.
July 25, 2026
APIMCP

Delta polling with sort=ingested

  • The feed has a polling mode. GET /api/news/?sort=ingested returns rows in the order they became available, so a bot can ask "what is new since my last call" instead of re-reading the first page. Call it once without a cursor, store the next_cursor, and pass it back on each later call. In this mode next_cursor is always present, and an empty results list means you are caught up. Every filter works unchanged: symbol, category, min_relevance, collapse=story.
  • Why a separate mode: articles reach the feed after their publish time. General news lands a median of about 33 minutes after publication and SEC filings in 5 to 9 minutes, so a poller that tracks time_published silently skips late arrivals. The ingest-order cursor cannot lose a row.
  • The same mode is on MCP: alphai_news_search and alphai_ticker_news accept a sort argument. MCP news items also carry a new created_at field, the moment AlphaAI received the article, matching the REST feed's original.created_at.
  • A cursor belongs to the mode that issued it, so pass the same sort value on every call of a run. A cursor replayed into the other mode is rejected, and so is one that was truncated or edited in storage: 400 on REST, invalid_cursor on MCP. It is an error rather than a fresh first page on purpose. In polling mode a quiet restart at the head would skip everything in between, and nothing in the response would tell you it happened.
  • Your plan's news-archive depth applies to where a poll resumes, not just to what it returns. On Free and Basic a cursor that resumes further back than your window is rejected: 403 with reason: archive_horizon on REST, an archive_horizon error on MCP. Poll on your plan's cadence and you will never see it. Pro has no window, so a Pro poller can resume from any position.
  • A ready-to-run poller and the recommended cadence per plan are on /developers; the formal contract is in the OpenAPI spec (1.15.0).
July 23, 2026
APIMCP

Share classes, 8-K categories, fresher trending

  • Ticker queries now cover the whole issuer. The feed's symbol= filter, alphai_ticker_news, alphai_insider_news, the per-ticker summaries and news alerts match every listed share class of a company: a query for GOOGL returns SEC filings tagged GOOG, and an alert on either class fires for filings tagged the other. Article tags stay as published.
  • SEC 8-K filings categorize by their primary item: an earnings release (Item 2.02) is earnings, a completed acquisition or disposition (Item 2.01) is mergers_acquisitions, and the remaining events keep corporate_actions. Historical rows are reclassified the same way, so category filters return them consistently.
  • 8-K relevance scores now read the attached press release. An earnings or acquisition 8-K from a widely followed issuer scores on the disclosure itself, up to 10, so a major print can clear a min_relevance=8 filter and reach trending. Other 8-K items keep their fixed scores.
  • Trending (GET /api/news/trending/, alphai_trending) ranks by relevance score decayed with article age and returns at most two stories per ticker, so the list follows the current tape instead of the strongest story of the past two days.
July 20, 2026
APIMCP

Any page size from 1 to 20

  • GET /api/news/ and GET /api/news/insider/ accept any page_size from 1 to 20 on every tier, including keyless traffic. Ask for page_size=3 to sample the feed cheaply while you build, or page_size=20 to walk it in half the round-trips. Leaving the parameter off still gives you 10.
  • Pro keys reach 50. A page above 20 without a Pro key returns 400, as does any value outside 1 to 50. A page is never quietly shrunk to a size you did not ask for. Cursor pagination is unchanged: pass each response's next_cursor back as cursor regardless of page size.
  • The MCP tools carry the same axis. page_size and limit reach 20 on Free and Basic, and 50 on Pro. MCP still caps an oversized request at your ceiling and returns the page, rather than failing the call.
  • The OpenAPI spec is at version 1.13.0 with the new bounds on both feed endpoints: OpenAPI spec.
July 15, 2026
API

Summary endpoints validate tickers and resolve crypto

  • /api/symbols/{ticker}/sentiment-summary/ and /insider-summary/ now return 404 for a ticker no symbol owns, with a pointer at /api/symbols/?search= to look up the right one. Zeros in a 200 response always mean a quiet window for a real listing, never a misspelled symbol. Response codes are documented in the OpenAPI spec.
  • Both endpoints accept the same ticker forms as the rest of the API. A bare crypto name resolves to its <SYM>-USD listing, so /api/symbols/DOGE/sentiment-summary/ returns Dogecoin's rollup and echoes DOGE-USD as the ticker. Delisted and renamed symbols stay addressable, and a symbol a stock or ETF already owns keeps its meaning: BTC is still the Grayscale ETF, BTC-USD the coin.
July 13, 2026
APIMCP

Crypto and foreign tickers, plus symbol search

  • News queries accept every market's ticker form. US equities are the bare symbol (AAPL). Cryptocurrencies use the <SYM>-USD form (BTC-USD), and foreign listings use the Yahoo suffix (VOD.L). The symbol parameter on /api/news/ and the /api/symbols/{ticker}/ path document this in the OpenAPI spec.
  • A bare crypto name now resolves to its suffixed ticker. ?symbol=DOGE on /api/news/ returns Dogecoin instead of an empty page, browsing to /stock/DOGE opens the coin, and the MCP alphai_ticker_news tool does the same. A symbol a stock or ETF already owns is left as is: ?symbol=BTC still returns the Grayscale ETF, so pass BTC-USD for the coin.
  • New search on /api/symbols/. Pass ?search= to resolve a company name or ticker prefix to matching symbols, with ticker-prefix matches first. search=bitcoin returns BTC-USD and search=nvda returns NVDA. It matches the alphai_tickers lookup on MCP.
July 12, 2026
APIMCP

Delisted tickers keep their history, renames stay connected

  • /api/symbols/{ticker}/ now resolves delisted symbols and reports their lifecycle: status, delisted_at, and renamed_to with the ticker the company continues under after a rename (EchoStar's SATS points to ECHO). Field details are in the OpenAPI spec.
  • News queries follow renames. ?symbol= on /api/news/ and /api/news/insider/ returns a delisted symbol's history instead of an empty page, and querying a renamed company's current ticker also matches articles tagged with its former ticker. Tags on past articles stay exactly as published.
  • On MCP, alphai_ticker_news and alphai_insider_news now serve any known symbol and set delisted and renamed_to on the result. unknown_ticker is reserved for symbol strings we do not recognize at all.
  • Creating a news alert requires an active symbol on both REST and MCP. Updating or removing an existing alert on a delisted ticker keeps working.
July 11, 2026
Platform

alphai-tui, an official terminal client

  • alphai-tui is an official open-source terminal dashboard, written in Rust and MIT licensed. Live quotes and candlestick charts sit next to the scored news feed with per-ticker sentiment, and a separate view streams SEC Form 4 insider activity. Everything comes from the public REST API with a regular ak_live_ key, and a free key is enough: the app fetches only what the visible view needs and caches each response for five minutes.
  • Install with brew install makeev/tap/alphai-tui or cargo install alphai-tui; prebuilt binaries for macOS, Linux and Windows, with checksums, are on the releases page.
  • The new alphai.io/tui page covers installation and the first run, and shows how to pair the dashboard with an AI agent over MCP in a terminal multiplexer.
July 11, 2026
APIMCP

Structured trade data on the insider feed

  • Items on /api/news/insider/ now carry a structured insider block, so you can read the trade instead of parsing the headline: side (buy, sell, or other, with the raw SEC transaction_code), shares, avg_price_usd, total_value_usd, a 10b5-1 plan flag, the reporting owner and their role, and the transaction date. A multi-tranche filing arrives as one event: shares and value are summed, the price is value-weighted, and money fields are decimal strings.
  • The same endpoint now accepts min_relevance (1 to 10), matching the main feed. Insider rows are scored from the event's total dollar value, so this works as a size filter: min_relevance=7 keeps roughly the $10M+ trades.
  • The MCP tool alphai_insider_news returns the same block on every item. Full schema in the OpenAPI spec and on the developers page. The Python and TypeScript SDKs pick it up in 0.3.0 with typed models and the new parameter.
July 10, 2026
PlatformDocs

A new n8n briefing template you can import in one click

  • Our flagship n8n workflow is now published in the official n8n template library, so you can add it to your instance in one click instead of loading JSON by hand.
  • The template pulls news, sentiment, and SEC Form 4 insider activity for your watchlist, flags the movers with rule-based red flags, writes a short briefing with GPT, and sends it by email with an urgent Discord ping. A small watchlist runs inside the free tier.
  • It joins the three starter workflows in the n8n integration guide. Your key stays in an n8n credential, and the same flow runs on n8n Cloud or self-hosted.
July 9, 2026
API

SDK 0.2.0 and did-you-mean validation errors

  • SDK 0.2.0 (PyPI and npm) adds a page-size control to the news feeds: page_size=50 in Python, pageSize: 50 in TypeScript, available on news.list, news.insider, and both auto-paginating iterators. The API accepts 10 (the default) or 50 with a Pro key, so deep pagination through the SDKs now takes a fifth of the requests. Upgrade with pip install -U alphai-sdk or npm i alphai-sdk@latest.
  • Validation errors now point at the parameter an endpoint actually takes. Sending limit or per_page to /api/news/ still returns 400, but the error message adds Did you mean 'page_size'?, and offset or page suggest cursor. Nothing changes on /api/symbols/, where limit and offset are real parameters for slicing the ticker list.
  • The full parameter tables live in the OpenAPI spec (now 1.10.1), with per-language details in the SDK changelogs on PyPI and npm.
July 8, 2026
MCP

OAuth at connect and API keys on the MCP server

  • API keys now authenticate the MCP server. The same ak_live_ keys that call the REST API are accepted on mcp.alphai.io/mcp as a static Authorization: Bearer header, so headless clients (n8n, cron bots, CI) can skip the browser OAuth flow entirely. A key session sees the full toolset and shares the per-account MCP rate budget with OAuth sessions on the same plan.
  • Create a key under Account → API keys and see the “API key (headless)” tab on alphai.io/mcp for ready-made n8n, Claude Code, Cursor, and curl snippets. Keys travel in the header only; query-string keys are not accepted. Revoking a key cuts MCP access immediately.
  • The full mcp.alphai.io/mcp surface now authenticates at connect: initialize and tools/list require a Bearer token, and an unauthenticated request answers 401 with a WWW-Authenticate pointer to the protected-resource metadata. In practice: your client shows the alphai login as soon as the server is added — not at the first tool call. Anonymous catalog introspection is no longer served; the tool list is documented on alphai.io/mcp.
  • OAuth discovery documents are also served at the path-suffixed well-known URLs — /.well-known/oauth-protected-resource/mcp and /.well-known/oauth-authorization-server/mcp — matching how MCP clients derive them from the resource URL.
  • Loopback redirect URIs match port-agnostically at /oauth/authorize: a desktop client registered with http://localhost:<port>/… can come back on a different ephemeral port without re-registering.
July 6, 2026
MCP

Free-text search and forgiving page sizes on the MCP tools

  • alphai_news_search now takes a free-text query (alias q) alongside its structured filters: company names, ticker symbols, and topic words in the query resolve to ticker and category filters. Explicit tickers or category still take precedence when you pass both.
  • Paginated tools now accept limit as an alias for page_size, and a page request above your plan's ceiling is capped to it (10 on Free and Basic, 50 on Pro) — you get a full page plus a next_cursor instead of an error.
  • MCP responses now carry a standing note that AlphaAI output is AI-generated financial information for research, not investment advice.
July 5, 2026
APIDocs

Official Postman collection

  • The whole REST surface is now packaged as an official Postman collection — the /api/news/* feed, trending, insider transactions, single-article and related lookups, plus the /api/symbols/* directory, details, sentiment and insider summaries, and peers. Import the collection and environment, set bearerToken to your API key, and call every endpoint without writing a line of code.
  • Requests target api.alphai.io and authenticate with Authorization: Bearer out of the box. Linked from the developer docs.
July 4, 2026
APIMCP

Insider feeds are now SEC Form 4 only

  • category=insider, the /api/news/insider/ feed, and the MCP alphai_insider_news tool now return SEC Form 4 insider transactions only — company officers, directors, and 10%+ owners buying or selling their own stock. 13F / institutional-stake and executive-change stories no longer appear on these surfaces.
  • Those stories haven't gone away — they stay in the general feed under their own category (most as other), reachable via /api/news/ and alphai_news_search. Only the dedicated insider surfaces were narrowed.
  • The result is a clean, deterministic Form 4 signal: one row per filing event, aggregated (total shares, volume-weighted price, total value) with a relevance score derived from the event size and its buy / sell / 10b5-1 shape. Full contract in the OpenAPI spec.
July 3, 2026
MCP

ChatGPT deep research support — search and fetch join the MCP toolset

  • The MCP server now implements ChatGPT's connector contract: two new tools, search and fetch, alongside the eleven alphai_* tools (thirteen total). Add mcp.alphai.io as a source in ChatGPT deep research and it can search the enriched news feed and pull per-article digests on its own.
  • search takes a natural-language query — ticker symbols (NVDA, BTC-USD), company names, and topic words (insider, earnings, ipo, crypto…) all resolve to the right filters. fetch returns the enriched digest for one result id: summary, per-ticker analysis, category, relevance score, and a canonical article link. Agents with precise filters should keep using alphai_news_search.
  • Same OAuth flow, tiers, and rate limits as every other tool — nothing to reconfigure. Connected clients that cache the tool list need a refresh to see the new tools (in ChatGPT: Settings → Apps → alphai → Refresh). Setup per client on the MCP page.
July 2, 2026
APIMCP

The full archive goes Pro — tiered depth, richer limit errors, alert delivery modes

  • News-archive depth is now part of the plan matrix. Free keys page the feeds (/api/news/, /api/news/insider/) back 30 days and Basic 90; Pro walks the full enriched archive — every article with its relevance score, per-ticker analysis and category, deep enough to backtest against. MCP search follows the same axis (Pro was previously capped at 365 days; the cap is gone). Requesting a cursor past your horizon returns 403 with extra.reason: archive_horizon — first pages and everything inside the window are unaffected.
  • alphai_news_search (MCP) is filter-first: query by tickers, category, from_date / to_date and min_relevance. The free-text q parameter has been removed — resolve companies to tickers with alphai_tickers and filter, or match text client-side on the returned titles and summaries.
  • Capped responses now tell you what to do about them. A REST 429 (and the archive 403) carries your tier, its limit_per_minute / limit_per_day, retry_after_seconds and an upgrade block naming the higher tiers' caps; the MCP 429 adds the same tier + upgrade fields. Full shapes in the OpenAPI spec (v1.10.0). One number moved with this release: Pro's per-minute burst is now 150/min (was 300); the 100,000/day volume is unchanged.
  • Alert delivery is now a plan capability: instant per-article delivery (email and webhooks) is Pro; Basic alerts arrive as the 06:00 UTC daily digest. Alerts that existed before today keep the delivery mode they were created with. Pro accounts choose per alert via delivery_mode (instant | digest) on PATCH /api/news/alerts/{ticker}/ or in account settings.
  • The plan license is now explicit: Free is for personal, non-commercial use; Basic covers commercial use inside your own organization; Pro additionally covers redistributing the enriched feed as an integrated part of your own product, with attribution to alphai. Offering the data as a standalone feed, dataset, or API stays an Enterprise conversation. Stated on pricing and in the terms.
July 1, 2026
PlatformDocs

AlphaAI in n8n — ready-made workflow templates

  • You can now wire the feed into n8n with no code. A new n8n integration guide covers setup, and three ready-to-import templates live at github.com/makeev/alphai-n8n-templates.
  • The three templates: trending news to Discord (rich cards with AI sentiment, relevance score and likely price impact), a daily watchlist digest by email, and SEC Form 4 insider alerts to Discord — each alert linking back to the full analysis.
  • Each is built on n8n's HTTP Request node against api.alphai.io with Bearer Auth, so your key stays in an n8n credential — never in the workflow — and the same flow runs on n8n Cloud or self-hosted.
June 18, 2026
APIDocs

Interactive API reference, and bulk page size on the feed

  • The REST API now has an interactive reference at api.alphai.io/api/schema/swagger-ui/ — browse every endpoint, query parameter and response shape, and fire authorized test calls straight from the page with your Bearer ak_live_… key. Browsing needs no key; the raw OpenAPI spec is linked at the top.
  • GET /api/news/ and GET /api/news/insider/ now take a page_size query parameter. Pro keys can request page_size=50 to receive 50 articles per page instead of the default 10 — fewer round-trips to walk the feed. Free and Basic keys stay at 10.
  • Only 10 and 50 are accepted; any other value returns 400, and page_size=50 without a Pro key returns 400. Cursor pagination is otherwise unchanged — pass each response's next_cursor back as cursor regardless of page size.
  • This brings the REST feed in line with the MCP server, which already served Pro callers 50 results per page. Full parameter reference in the OpenAPI spec (now 1.9.0).
June 17, 2026
APIMCP

Crypto and global equities join the symbol universe

  • Cryptocurrencies are now first-class symbols. The top ~200 coins by market cap are returned by GET /api/symbols and the MCP alphai_tickers tool, with asset_type: "Crypto". Crypto tickers carry a -USD quote suffix — BTC-USD, ETH-USD, SOL-USD — so they never collide with the US spot-crypto ETF tickers.
  • The symbol shape gained two fields, country and currency, and ticker path parameters now accept the suffixed form (e.g. /api/symbols/BTC-USD/). Full reference in the OpenAPI spec (now 1.8.0).
  • Crypto news is now classified and tagged: an article about a coin lands under the crypto category with the coin's -USD ticker, so it flows into /api/news, alphai_ticker_news, and the other feed and ticker surfaces.
  • Foreign (non-US) equities are now in the universe too. Listings from global exchanges — London (LSE), Frankfurt (XETR), EURONEXT, Tokyo (TSE), Hong Kong (HKEX), Korea (KRX), … — are returned by GET /api/symbols and the MCP alphai_tickers tool. They carry the Yahoo-style ticker suffix — VOD.L, 7203.T, 0700.HK, 005930.KS, MC.PA — with exchange set to the venue prefix and country / currency populated.
  • News about a foreign-only company is tagged with its suffixed ticker, so it flows into /api/news, alphai_ticker_news, and the other ticker surfaces. For companies that also trade in the US, news prefers the US listing — e.g. Toyota coverage lands on TM, not 7203.T.
June 16, 2026
APIMCP

Two-layer rate limits: per-minute burst + per-day volume

  • REST and MCP rate limits are now two layers per tier — a per-minute burst cap and a per-day volume cap; a request passes only when both are under budget. Current limits, applied independently to REST and MCP: Free 20/min · 100/day, Basic 60/min · 10,000/day, Pro 300/min · 100,000/day.
  • The X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers now report your daily volume budget, with Reset at the next 00:00 UTC. A per-minute burst surfaces only as a 429 with a short Retry-After (a daily-cap block caps Retry-After at 3600s).
  • On MCP, a 429 body now includes a window field — "minute" or "day" — so you can tell a burst from a daily cap.
  • The Free tier is now for evaluation / non-commercial use; production or commercial workloads require a paid plan. See pricing.
  • Ticker discovery on MCP (alphai_tickers) now ranks ticker-prefix matches ahead of company-name matches for the q filter — so q=NV returns NVDA, NVAX, … first, then names that merely contain "nv".
  • The default relevance floor dropped from 6 to 4. /api/news/, the MCP query tools (alphai_news_search, alphai_ticker_news, alphai_insider_news, alphai_pair_analysis) and the site feeds now return articles scoring 4+ by default instead of 6+ — more depth per ticker. Pass a higher min_relevance to restore the stricter view. Trending (alphai_trending) keeps its 8+ bar.
June 15, 2026
APIMCP

Insider transactions: direct vs. indirect

  • Insider (SEC Form 4) news now carries an ownership_form field — "direct" or "indirect", and null on non-insider news. It sits at original.ownership_form on the REST feed and at the top level of every MCP news item.
  • One Form 4 can report a sale from an insider's direct holdings and from indirect holdings (e.g. a trust or fund) as two items that share the same filing URL and date. They are distinct economic events — sum them, don't dedupe by URL or accession number. Indirect items are now also flagged in the headline with (indirect holdings).
  • Full field reference in the OpenAPI spec.
June 14, 2026
APIDocs

Official Python and TypeScript SDKs

  • Typed clients now wrap all nine REST endpoints, so you can skip hand-rolling requests: pip install alphai-sdk (import alphai) or npm install alphai-sdk (import AlphaAI).
  • Both ship cursor auto-pagination, automatic retries on 429/5xx with Retry-After backoff, typed errors, and rate-limit inspection. They read ALPHAI_API_KEY from the environment and target api.alphai.io by default. The Python client offers sync and async; the TypeScript client runs on Node, browsers, edge, Deno, and Bun with zero runtime dependencies.
  • Get them on PyPI and npm, with quickstarts on the developers page. The REST contract is unchanged — the SDKs are entirely optional.
June 13, 2026
APIMCP

Story clustering — one row per story, not per reprint

  • When one event is reported by many outlets, you can now collapse the reprints into a single row. Pass ?collapse=story on /api/news/, or collapse_stories=true on the MCP alphai_news_search and alphai_ticker_news tools, to get one representative article per story instead of every syndicated copy.
  • Collapsed items carry three new fields: story_id (the representative's UID, resolvable via /api/news/{uid}/), sources_count (how many outlets ran the story — a corroboration signal), and sources (the distinct source domains). They are null in the default, uncollapsed feed.
  • Trending surfaces now collapse reprints by default: /api/news/trending/ and the MCP alphai_trending / alphai_actionable_now tools return one entry per story, keeping the highest-ranked copy.
  • Full field reference in the OpenAPI spec and on the developers page.
June 9, 2026
APIMCP

SEC 8-K corporate events in the feed

  • A new category, corporate_actions, surfaces issuer 8-K events straight from SEC EDGAR — earnings, material agreements, new debt, executive changes, and annual-meeting vote results — enriched with per-ticker analysis like the rest of the feed. On these rows source reads SEC EDGAR 8-K.
  • Filter them with ?category=corporate_actions on /api/news/ (CSV or repeated to combine with other buckets), or the category argument on the MCP alphai_news_search tool.
  • Relevance tracks event materiality: earnings and completed acquisitions score 7; material agreements, new debt, executive changes, and annual-meeting results score 6 — at the default min_relevance feed floor, so they appear without any filter.
June 7, 2026
DocsAPIMCP

Insider data, tickers, and quota headers in the contract

  • Form 4 insider news arrives one article per filing event: all of a filing's trades of one type (and holding form) collapse into a single item. The title carries the event's total dollar value; the summary carries total shares, the volume-weighted average price with the executed range, and the trade count — a 10b5-1 ladder sale is one article, not one per price tranche.
  • Relevance scores for Form 4 articles are computed from the whole event — tranches sum before the size bands apply — so a plan sale executed across dozens of small steps scores by its total, and min_relevance filters see it accordingly.
  • Every news response now carries enrichment.tickers — the validated symbols the article mentions (only tickers present in /api/symbols/), the same top-level list the MCP server returns. Per-ticker detail stays in ticker_analysis.
  • Every keyed response now carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, so you can watch your remaining budget without provoking a 429 — which still adds Retry-After.
  • Errors on the API surface are JSON end to end: unknown paths now answer {"message": "Not found."} with the same shape as every other API error.
  • /api/symbols/ takes optional limit and offset params — slice the ~10k-ticker list instead of downloading it whole. Without them the full bare array comes back unchanged; the list is alphabetical by ticker either way.
  • OpenAPI 1.3.0 at /api/schema/ now covers the per-ticker rollups: /api/symbols/{ticker}/sentiment-summary/ (7-day bullish / neutral / bearish counts) and /insider-summary/ (30-day Form 4 stats: buy/sell counts, dollar volumes, 10b5-1 share, top insiders) — with full response schemas.
  • Also added to the spec: the market_movers category (13 total), Symbol.exchange, and the exclude_categories filter on /api/news/.
  • alphai_actionable_now takes a new min_actionability parameter. The feed is gated to articles the enricher scored actionability="high" — a concrete decision to act on today — so an empty list outside US market hours means a quiet tape, not an error. Pass min_actionability="medium" to also include stories that shape a position over days or weeks; the default stays "high".
  • /developers gained a dedicated insider-data guide with live playground presets; /mcp now carries the full 11-tool reference — including alphai_actionable_now (breaking, high-actionability news) and alphai_pair_analysis (cross-ticker read-across) — plus a per-plan limits table.
June 6, 2026
APIMCP

Relevance scoring recalibrated

  • Scores now rate the article, not the company it mentions: a recap of a mega-cap's week-old earnings scores low; a small-cap's fresh FDA approval scores high.
  • Scoring is deterministic — the same article always gets the same score — and SEC Form 4 rows are scored from the transaction itself (size, buy vs. sell, 10b5-1 plan or not) rather than by the model.
  • If you filter on min_relevance, expect cleaner separation: derivative coverage drops out of the mid band, and the ≥8 band in /api/news/trending/ tightens to primary, market-moving disclosures.
May 25, 2026
API

api.alphai.io — a dedicated API host

  • New key-only base URL that bypasses the website CDN: no shared edge cache between your bot and the data, predictable latency. The same routes on alphai.io keep answering as before.
  • The OpenAPI spec at api.alphai.io/api/schema/ is downloadable without a key.
May 24, 2026
APIMCPPlatform

Public launch: REST API, MCP server, insider feed, alerts

  • REST API with API-key auth and hourly tiers — Free 100, Basic 1,000, Pro 10,000 — plus an OpenAPI 3.1 contract at /api/schema/.
  • MCP server at mcp.alphai.io: OAuth 2.1 with dynamic client registration and PKCE, Streamable HTTP, flat deterministic response shapes keyed by article uid.
  • SEC Form 4 insider transactions surfaced as first-class news rows (category=insider) shortly after EDGAR publication.
  • Ticker news alerts over email, with Pro webhooks: HMAC-SHA256-signed deliveries (Stripe-style X-Alphai-Signature) and exponential-backoff retries.

Earlier history predates the public API. Questions about a change? Get in touch.