AlphaAI
Public REST API for AlphAI's relevance-scored, ticker-linked financial news. All endpoints accept Authorization: Bearer ak_live_… (issued from your…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Public REST API for AlphAI's relevance-scored, ticker-linked financial news.
All endpoints accept Authorization: Bearer ak_live_… (issued from your/account/api-keys). Authenticated traffic is metered per account with two
layers — a per-minute burst cap and a per-day volume cap (Free 20/min +
100/day, Basic 60/min + 10,000/day, Pro 150/min + 100,000/day); a request
passes only if both are under budget. The Free tier is for evaluation /
personal non-commercial use; Basic is licensed for internal commercial use;
Pro adds redistribution of the enriched feed. Send all API traffic toapi.alphai.io; a key is required on every request.
The API is server-side only. It sends no CORS headers, so a cross-origin
call from a browser page fails at the preflight: the OPTIONS request is
answered with 403 at the edge and never reaches the API. Keep the key on
your server and expose your own route to the browser; a key embedded in
page code is readable by every visitor and spends your quota.
Every keyed response carries X-RateLimit-Limit, X-RateLimit-Remaining
and X-RateLimit-Reset; these report the per-day volume layer (Reset =
epoch seconds of the next 00:00 UTC reset) so you can watch your daily budget
without provoking a 429. A per-minute burst surfaces only as a 429 with a
short Retry-After. A 429 body also names your tier, its caps and anupgrade block. A request rejected with 429 does not itself spend quota.
The headers reflect origin processing, so a response served from a shared
cache may omit them.
On the MCP server (mcp.alphai.io) the same two layers meter **tool calls
only** — the connect handshake (initialize, tools/list, notifications,
keepalives, the SSE stream) is protocol traffic and does not consume your
quota. It carries a separate, far larger ceiling that exists only to stop a
client reconnecting in a loop; hitting it returns a 429 whose body reports"window": "transport", which means your client is reconnecting too often,
not that you are out of quota.
MCP news tools accept detail="compact" for headline triage and polling:alphai_news_search, alphai_ticker_news, alphai_insider_news,alphai_trending, alphai_actionable_now, alphai_macro andalphai_pair_analysis. Compact items keep identity, source, publication
and ingest times, tickers, category, relevance_score, top-level
actionability and information_novelty, story fields, ownership_form and
search_match. Summary, analysis, images and SEC detail blocks are omitted;
fetch alphai_article(uid) for those details. detail="full" is the
default and preserves the existing format, including the condensed recent
lists on pair_analysis. Selection, order, cursors, query interpretation
and macro releases are unchanged, so detail can change between pages.
This parameter belongs to MCP tools only; REST parameters are unchanged.
Interactive MCP clients use a separate OAuth approval flow. Check the
callback host or app scheme and full callback address before approving;
app names are self-declared, not verified by AlphAI. MCP access includes
news, market data and the saved watchlist, plus creating, changing and
disabling the user's own alerts on Basic or Pro (including after an
upgrade). The OAuth scope tools.read is not a read-only restriction.
Registered callbacks can be reviewed in Account → MCP connections.
That account management surface requires website login, not an API key.
Disconnect blocks all existing MCP OAuth access and refresh tokens for that
app connection, including its other sessions; work already in progress may
finish. Other connections and API keys are unaffected. Revoking either token
type through the separate MCP host's /oauth/revoke has the same effect.
Serialize refresh requests and save each replacement token: reuse ends the
connection. MCP /oauth/token returns HTTP 400 with error: invalid_grant
and an error_description for expired, revoked or reused credentials;
restart authorization instead of retrying the same credential. A backing-store
outage returns 503 with Retry-After; retry later without treating it as revocation.
News-archive depth is tiered: Free keys can page the feeds back 30 days,
Basic 90 days, Pro 180 days. Paging past your horizon returns 403
with an extra.reason of archive_horizon (see the ArchiveGated response).
Coverage note: our collectors expanded in June 2026, so archive months
before 2026-06 hold fewer articles per day than the current feed.
Insider data (SEC EDGAR Form 4) flows through the same news shape:category=insider rows in the feed, a dedicated /api/news/insider/
route, and 30-day per-ticker rollups at/api/symbols/{ticker}/insider-summary/. For charts and analysis there
is /api/symbols/{ticker}/insider-trades/: the complete per-ticker
event history with 3m/12m/all-time rollups, weekly and monthly dollar
buckets, and every event of the trailing 12 months in one response.
Both rollups count a co-filed block once: when the direct holder…
Endpoints 27
news
- GETList news (cursor-paginated)
/api/news/Feed of enriched articles, newest first. Default filter: relevance_score >= 4 AND at least one active ticker. Pagination is cursor-based with a default page… - GETFull-text search over the feed
/api/news/search/?q=Jane StreetSearch the enriched feed by words. q is matched against each article's title, its summary and the entity names the enrichment extracted; the page comes back… - GETTrending news (last 48h)
/api/news/trending/Top stories from the trailing 48h: relevance_score >= 8, ranked by relevance score decayed by article age, so a fresh story outranks an equally-scored stale… - GETInsider-transaction news (SEC Form 4)
/api/news/insider/Dedicated insider feed (category=insider): SEC EDGAR Form 4 insider activity ONLY — one deterministic-templated row per filing event (a filing's… - GETInsider cluster buys (several insiders of one issuer buying together)
/api/news/insider/clusters/Episodes in which several different insiders of one issuer bought on the open market together: an issuer's Form 4 purchase dates are chained into one episode… - GETMarket-wide macro news (central banks, prints, commodities, geopolitics)
/api/news/macro/Dedicated macro feed: the macro_economy, commodities and geopolitics categories in one stream — central-bank decisions and statements (FOMC), inflation/jobs… - GETA compact brief across multiple tickers
/api/news/brief/?tickers=NVDA,AMD,BTC-USDOne response with recent news grouped by story, a separate SEC Form 4/8-K/6-K filings section, and the next confirmed earnings date per ticker. Supply your… - GETGet a news article by UID
/api/news/:uid/One enriched article. SEC rows carry the same structured block the feeds serve: insider on a Form 4 row (as on /api/news/insider/), filing on an 8-K row (as… - GETArticles related to one article
/api/news/:uid/related/Up to 6 articles related to the given article: fresh articles sharing a ticker first, then same-category recents as backfill. Same enriched shape and…
stories
- GETTop stories (last 48h)
/api/stories/top/The strongest stories of the trailing 48 hours, ranked: a story's importance plus a coverage bonus of min(3, log2(publishers)), minus one point per 12 hours… - GETLatest stories (cursor-paginated)
/api/stories/Stories newest-first by the time of their latest article (last_material_at): stories with a published summary and importance >= 7. Keyset pagination: omit… - GETGet a story by its id
/api/stories/:story_id/One story — the summary AlphAI wrote from its articles, the key facts each with the publisher it was read from and the source_uid of that article, the… - GETA story's articles (cursor-paginated)
/api/stories/:story_id/materials/Every article behind a story, oldest first — the materials the summary was written from and the ones that joined after it. Same visibility as the feed…
symbols
- GETList active tickers
/api/symbols/All active symbols (US equities, US exchange-traded funds, crypto, and foreign listings), alphabetical by ticker. ~16k entries — cache aggressively, or slice… - GETSymbol detail
/api/symbols/:ticker/ - GET7-day AI sentiment rollup for one ticker
/api/symbols/:ticker/sentiment-summary/Counts of bullish / neutral / bearish per-ticker sentiment calls from the enriched news flow, plus per-day buckets. The window is the last 7 UTC calendar… - GET30-day insider-transaction rollup for one ticker
/api/symbols/:ticker/insider-summary/Aggregated SEC Form 4 activity over the trailing 30 days: buy/sell transaction counts, dollar volumes, the share of transactions executed under pre-arranged… - GETAlphAI earnings reads for one ticker, plus its next report date
/api/symbols/:ticker/earnings/Every published AlphAI earnings read for the ticker, newest first, and the date of its next report when the source marks one as confirmed. A read is written… - GETMost recent AlphAI earnings read for one ticker
/api/symbols/:ticker/earnings/latest/A pointer to the ticker's most recent published earnings read (SEC 8-K item 2.02, or a foreign private issuer's 6-K earnings release). Resolve the full… - GETForm 4 event history and chart aggregates for one ticker
/api/symbols/:ticker/insider-trades/The complete per-ticker insider-trading payload behind alphai.io/stock/{ticker}/insider-trades: the paginated Form 4 event history plus everything a chart… - GETRelated tickers for one ticker
/api/symbols/:ticker/peers/Other companies in the same industry (widening to the broader sector when the industry is thin) that carry recent enriched news, most recently covered first.… - GETStock directory — most-covered tickers and sector cards
/api/symbols/directory/The hub index behind /stocks: the globally most-covered tickers over the trailing window, plus one card per sector (size + its busiest names). Ranked by… - GETOne sector's most-covered tickers
/api/symbols/sectors/:slug/The tickers in a sector (by slug, e.g. financial-services), ranked by recent enriched-news coverage. Powers the /stocks/{slug} sub-pages. Returns up to 500…
calendar
- GETScheduled US macro releases (economic calendar)
/api/calendar/The official forward schedule of US macro releases: FOMC decisions (with SEP and press-conference markers) and minutes, CPI, PPI, the jobs report (nonfarm… - GETWho reports when and who just reported (earnings calendar)
/api/calendar/earnings/Companies with an upcoming report date, by day. Only dates the source marks as confirmed are listed; estimates are left out, so later days fill in as…
radar
- GETRank market or saved-watchlist news activity
/api/signals/snapshot/Descriptive news-activity ranking. Free delay 3600 seconds; Basic 900 seconds; Pro no added delay. Tier and watchlist owner come from authentication, never…
coverage
- GETCoverage passport — what each data source holds, from when, with which caveats
/api/coverage/One object per data source: publisher_news (the GDELT stream, RSS feeds and directly parsed publisher pages), sec_form4, sec_form8k, sec_form6k,…
API details
- Base URL
https://api.alphai.io- Authentication
- A bearer token in the Authorization header
- Operations
- 27 operations on 27 pathsGET 27
- Main resources
- symbols 10news 9stories 4calendar 2coverage 1radar 1
- Response formats
application/jsontext/csv- Description format
- OpenAPI 3.1.0, API version
1.63.0 - Links
- OpenAPI document · Support
How to test the AlphaAI in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the AlphaAI collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List news (cursor-paginated)” (GET /api/news/), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the AlphaAI?
Public REST API for AlphAI's relevance-scored, ticker-linked financial news. All endpoints accept Authorization: Bearer ak_live_… (issued from your… It is listed under Finance & banking and has 27 endpoints.
Who publishes the AlphaAI?
It is listed from AlphAI's public API description (an OpenAPI document), not published by AlphAI on Swastik Codes. Anyone who controls alphai.io can claim the profile by adding a DNS TXT record.
What is the base URL of the AlphaAI?
Requests go to https://api.alphai.io. Endpoint paths are added to this base URL.
How do I authenticate with the AlphaAI?
With A bearer token in the Authorization header.
How many endpoints does the AlphaAI have?
27 operations on 27 paths (27 GET). The largest groups are symbols, news, stories, calendar.
Is forking the AlphaAI free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.