Skip to main content
StockContext gives an AI agent the analyst core it needs for active US-listed stocks and ETFs. The same context comes back over REST and a hosted MCP server: fresh quotes and performance, valuation read against a symbol’s own history, fundamentals, technicals, SEC filings with primary text and sections, insider activity, dividends, earnings actuals and company-stated guidance, SEC-derived events, multi-symbol compare, and search and coverage. The JSON is shaped to act on, not just parse: grades, valuation multiples ranked against the symbol’s own history (percentile + label, never against peers or a fair-value target), adaptive valuation anchors, and machine-readable reasons when a metric does not apply. One call answers what this symbol is, how it is trading, how expensive it is against its own history, what its filings and insiders say, and how fresh the data is.

​
Start here

Pick the surface that matches how you call APIs. Both authenticate with the same sctx_ key in the X-API-Key header.

REST quickstart

Create a key, call GET /v2/snapshot?symbol=AAPL, and read the response. Five minutes from zero to a parsed snapshot.

Hosted MCP

Point an MCP client at https://api.stockcontext.com/mcp and call the stockcontext_* tools that wrap the same routes. Every tool is a GET, safe to call in any agent loop.

​
Coverage

5,628 US-listed symbols on NYSE, NASDAQ, NYSE ARCA, and BATS/Cboe BZX, covering 5,571 stocks and 57 ETFs. Daily price history runs back up to 30 years, bounded by source availability per symbol. Some data families do not apply to every symbol, so check coverage and gaps for the exact support map before you commit to a route.

​
What to call for what

Start narrow with /v2/search, /v2/coverage, and /v2/snapshot, then add depth only when the question needs it. Routes tagged Paid need Starter or Builder and return 403 PLAN_UPGRADE_REQUIRED on a Free key. The endpoint guide maps jobs to the smallest route set.
NeedRoutesPlan
Discovery/v2/search, /v2/coverageFree
First-pass context/v2/snapshot (Free), /v2/profile (Paid)Mixed
Valuation and fundamentals/v2/valuation (Free), /v2/fundamentals, /v2/earnings, /v2/dividends (Paid)Mixed
Events/v2/calendarPaid
Price behavior/v2/technicals, /v2/price-action, /v2/history, /v2/comparePaid
SEC and insider context/v2/filings, /v2/filings/{accession}, /v2/filings/{accession}/section/{name}, /v2/insiderPaid
Free keys can call /v2/search, /v2/coverage, /v2/snapshot, and /v2/valuation. Starter and Builder reach every public core route. See plans and limits for rate limits and quotas.
Segments, ownership/13F/13D-G, and governance are being validated as private beta families. They are not part of the default public core, public MCP tool list, or agent recipes until their coverage gates are strong enough.

​
Where the data ends

StockContext is focused on equity context, so an agent always knows exactly where the data ends and never guesses. It does not return:
  • real-time exchange-grade or L2/order-book ticks
  • options, implied vol, futures, or global-equities coverage
  • analyst consensus, price targets, transcripts, or news
  • ETF AUM, expense ratios, or holdings where the SEC N-PORT resolver has not collected them
  • sector or peer medians (each multiple is ranked against the symbol’s own history only)
  • a screener or full cross-symbol database
  • execution or investment advice

​
Next step

New to the API? Start with the REST quickstart. If you already know the shape of the data, the API reference lists every route, param, and field.