GET under /v2 at https://api.stockcontext.com, authenticated with your sctx_ key in the X-API-Key header.
Routes
The access column lists the plans that can call each route. See plans and limits for the rate limits and quotas behind those names.| Route | Access | Use |
|---|---|---|
GET /v2/search | Free, Starter, Builder | Symbol discovery from a name or query. |
GET /v2/coverage | Free, Starter, Builder | Supported-universe and asset-type check. |
GET /v2/snapshot | Free, Starter, Builder | One-shot market and fundamental context. |
GET /v2/valuation | Free, Starter, Builder | Valuation and multiples context. |
GET /v2/priced-in | Starter, Builder | Reverse-DCF: the FCF growth the price implies. |
GET /v2/profile | Starter, Builder | Company profile and ETF fund facts/holdings where collected. |
GET /v2/fundamentals | Starter, Builder | Income, balance sheet, and cash flow rows. |
GET /v2/facts | Starter, Builder | Curated SEC fact grid with provenance and PIT queries. |
GET /v2/earnings | Starter, Builder | Earnings history and context. |
GET /v2/dividends | Starter, Builder | Dividend and payout history. |
GET /v2/technicals | Starter, Builder | Technical indicators. |
GET /v2/price-action | Starter, Builder | Recent price action and range context. |
GET /v2/history | Starter, Builder | Selected historical series. |
GET /v2/compare | Starter, Builder | 2–12 symbol scorecard. |
GET /v2/calendar | Starter, Builder | Per-symbol upcoming events. |
GET /v2/filings | Starter, Builder | Recent SEC filings. |
GET /v2/filings/{accession} | Starter, Builder | Filing metadata and section index. |
GET /v2/filings/{accession}/section/{name} | Starter, Builder | Full section text. |
GET /v2/filings/{accession}/diff | Starter, Builder | Section-level filing diff against the prior comparable filing. |
GET /v2/insider | Starter, Builder | Trailing 90-day Form 4 activity and Form 144 notices. |
GET /v2/events | Starter, Builder | SEC-derived event labels and filing events. |
Response shape
Success is{ "data": ... }; failure is { "error": { "code", "message", "retryable" } }. The public analyst core exposes 21 routes across the core symbol-varying families plus route-specific filing subresources. Private-beta REST endpoints can remain callable for enabled integrations, but they are not part of the default public route table.
Every success payload — and every unsupported payload — carries freshness, as_of, market_status, and cache_age_seconds (int; 0 when freshly computed). freshness is one of intraday, end_of_day, stale, degraded, or unsupported. An unsupported response is a full envelope, not an error, and you parse it the same way.
Query conventions
- Symbols are US tickers up to 8 characters; dot share classes such as
BRK.Bnormalize toBRK-B. - Multi-value params are comma-separated:
symbols=AAPL,MSFT,form=10-K,10-Q. GET /v2/comparetakes 2–12 distinct symbols.GET /v2/filingsaccepts up to 4 forms from10-K,10-Q,8-K,4,UPLOAD, andCORRESP.GET /v2/historytakes up to 3 series, all on a single cadence.- Timestamps are UTC ISO-8601 unless a field documents otherwise.
- Currency fields suffix
_usd; percent fields suffix_pctand are percentages, not decimals.
Response examples
The JSON in every endpoint page is a real production payload captured against the live API, trimmed where noted. The error codes page lists each code, its HTTP status, and whether it is retryable.Playground
Generated endpoint pages include a live playground for manualGET /v2/* calls. Paste your key into the masked X-API-Key field; keys you enter are sent directly to the API for that request and are never stored. Avoid the playground on shared machines.
OpenAPI
These endpoint pages are generated from the FastAPI OpenAPI spec inopenapi.json.
If a generated schema and a prose guide disagree, trust the OpenAPI schema and the live API, and file a docs bug so the prose can be corrected.