Stock Market API
Integrate News.gg’s normalized market data, discovery, event, research, and streaming feeds.
Quickstart
Create a key in the dashboard, keep it on your server, and pass it as a bearer token. Your first quote request looks like this:
curl "https://api.newsdiscordbot.xyz/api/stock-market/quote/AAPL" \ + -H "Authorization: Bearer $NEWSGG_API_KEY"
const response = await fetch(
"https://api.newsdiscordbot.xyz/api/stock-market/quote/AAPL",
{ headers: { Authorization: `Bearer ${process.env.NEWSGG_API_KEY}` } }
);
const quote = await response.json();Authentication
Use the Authorization header on every request. Keys begin with ngg_live_ and are displayed once when created.
Never embed a secret API key in browser JavaScript, mobile binaries, public repositories, or query strings. Rotate a key immediately if it is exposed.
Limits and response headers
Quota is enforced per developer account. All authenticated responses include current allowance information.
X-RateLimit-LimitAllowed calls per minuteX-RateLimit-RemainingCalls left in the current minuteX-Monthly-LimitPlan allowance for the monthX-Monthly-RemainingCalls left this monthX-Bandwidth-LimitMonthly streaming allowance in bytesX-Bandwidth-RemainingStreaming bytes left this monthRetry-AfterSeconds to wait after a minute limitErrors
Errors use a stable JSON envelope: { "status": "error", "code": "rate_limit", "message": "…" }
400Invalid parameter or request body401Missing, invalid, revoked, or inactive key429Minute, monthly request, or streaming bandwidth limit reached500Unexpected upstream or service failureEndpoints
32 documented operations across the market data API.
Core data
/quote/{ticker}Latest quote with normalized OHLCV, change, company, sector, and source.
/quoteRequest a quote with a ticker in the JSON body.
/quotes?symbols=AAPL,TSLAFetch multiple normalized quotes in one request.
/last-trade/{ticker}Most recent trade and tape metadata for a symbol.
/technicals/{ticker}Technical indicators and momentum context for a symbol.
/financials/{ticker}Key company financial metrics and fundamentals.
Discovery
/screener/page?page=1Paginated market-wide OHLCV screener data.
/screener/sweepSweep multiple screener pages in a single job.
/moversCurrent gainers, losers, and most active symbols.
/most-activeStocks ranked by current session activity.
/new-highs-lowsSymbols reaching session and period extremes.
Signals
/squeeze-alertsMarket-wide short-squeeze candidates and scoring.
/squeeze/{ticker}Detailed squeeze setup for one symbol.
/whalesMarket-wide block trade and unusual size activity.
/whales/{ticker}Large-trade activity filtered to one symbol.
/haltsCurrent market halts, reasons, and resumptions.
Research
/ratings/{ticker}Analyst actions and rating changes for a symbol.
/news/{ticker}Recent market news associated with one ticker.
/newsMarket-wide financial news feed.
Events
/filings/{ticker}Recent SEC filings with form filters and limits.
/insider-transactions/{ticker}Reported executive and director transactions.
/dividends/{ticker}Dividend history and upcoming distributions.
/earnings/{ticker}Earnings dates and reported results.
/short-interest/{ticker}Short interest and days-to-cover context.
/congress-tradesRecent disclosed congressional stock transactions.
/ipo-calendarUpcoming and recent public offerings.
Macro
/fear-greedCurrent market sentiment indicators.
Alternative data
/social/{ticker}Public social conversation for one symbol.
/social/trendingSymbols trending across the social feed.
Biopharma
/fda/{ticker}Approvals, clearances, and regulatory events.
/biopharma/{ticker}Clinical readouts and biopharma reporting.
Streaming
/ws/trades/stream?symbols=AAPL,TSLAServer-sent events stream for live multi-symbol trade updates.