Radar

scope=market (default) scans eligible tickers, with no tier-based ticker cap. scope=watchlist requires authentication and reads the caller’s saved watchlist. The existing watchlist allowance applies: Free 10, Basic and Pro unlimited. An empty watchlist returns an empty result.

The server derives your plan from your account: Free 60 minutes, Basic 15 minutes, Pro no added delay. It selects the entire eligible snapshot, including its evidence. Changing filters never bypasses the delay. Do not pass a tier or user ID.

Use Authorization: Bearer YOUR_API_KEY from your server. The website uses your signed-in session. Normal API and MCP request quotas apply. The watchlist scope requires authentication.

window

4h or 24h (default); measured before the snapshot’s cutoff

market

all, us_equity, crypto or international

ticker

One exact symbol, case-insensitive; no alias expansion

tickers

Comma-separated exact symbols instead of ticker; works within the selected scope

search

Ticker substring for interactive search, up to 32 characters

sort / order

score, stories, model_stories, sentiment or sentiment_change; asc or desc (default). Missing values always last.

sentiment

all (default), negative (<−0.15), positive (>0.15) or mixed. Missing sentiment matches only all.

min_z

Optional minimum activity score, 0–8

limit / cursor

1–100 rows per page (default 50). Follow next_cursor or previous_cursor with the same filters and page size to keep one complete snapshot. A changed plan, watchlist or expired snapshot returns 409: restart without cursor. Legacy offset is available but does not pin a snapshot. Page size is not a ticker allowance.

as_of is the actual data cutoff. access describes the applied plan, delay and scope. preview_reference_at is null in live mode. Missing metrics include a reason; only tickers with news in the selected window appear. Watchlist membership matches exact saved symbols.

freshness reports the actual delay, generation time and source watermark. Collection and enrichment add processing time. Live snapshots refresh every minute and remain available for three hours. snapshot_id identifies the complete snapshot, including its frozen titles and company names. watchlist_coverage separates quiet companies from symbols absent from this snapshot.

Total stories include broad coverage. Model stories exclude it and are compared with a market-adjusted expectation using the previous baseline. News tone requires sufficient analyzed stories and coverage; missing values are not neutral. These descriptive scores are not price predictions or confirmed alerts. Collection coverage is unverified. Historical corrections can affect the baseline; this is not a point-in-time backtest.

Responses are private and never cached by shared proxies. Invalid parameters return 400; an unavailable eligible snapshot returns 503, with no fallback to newer data.