API reference overview

Base URL

https://api.noxstock.com

All current product routes are GET routes under /v2.

Authentication

Pass your API key in the X-API-Key header:

curl "https://api.noxstock.com/v2/snapshot?symbol=AAPL" \
  -H "X-API-Key: $NOXSTOCK_API_KEY"

Current routes

Route	Access	Use
`GET /v2/search`	Free+	Symbol discovery.
`GET /v2/coverage`	Free+	Supported universe and asset type check.
`GET /v2/snapshot`	Free+	One-shot market/fundamental context.
`GET /v2/valuation`	Free+	Valuation and multiples context.
`GET /v2/profile`	Starter+	Company/ETF profile details.
`GET /v2/fundamentals`	Starter+	Income, balance sheet, cash flow rows.
`GET /v2/earnings`	Starter+	Earnings context.
`GET /v2/dividends`	Starter+	Dividends and payout context.
`GET /v2/technicals`	Starter+	Technical indicators.
`GET /v2/price-action`	Starter+	Recent price action and range context.
`GET /v2/history`	Starter+	Selected historical series.
`GET /v2/compare`	Starter+	2–4 symbol scorecard.
`GET /v2/calendar`	Starter+	Per-symbol upcoming events.
`GET /v2/filings`	Starter+	Recent SEC filings.
`GET /v2/filings/{accession}`	Starter+	Filing metadata and section index.
`GET /v2/filings/{accession}/section/{name}`	Starter+	Full section text.
`GET /v2/insider`	Starter+	Trailing 90-day Form 4 activity.

Query conventions

Symbols are US tickers, max 8 chars. Dot share classes are normalized by REST.
Multi-value params are comma-separated: symbols=AAPL,MSFT, form=10-K,10-Q.
Timestamps are UTC ISO-8601 strings unless a field documents otherwise.
Currency fields use explicit suffixes where helpful, for example _usd.
Percent fields use _pct and are percentages, not decimals.

OpenAPI

The endpoint pages in this section are generated from the real FastAPI OpenAPI spec in openapi.json.

If the generated schema and a prose guide disagree, treat the OpenAPI schema and live API as source of truth. File a docs bug so the prose can be corrected.