news

A compact brief across multiple tickers

One response with recent news grouped by story, a separate SEC Form 4/8-K/6-K filings section, and the next confirmed earnings date per ticker. Supply your symbols explicitly; this endpoint does not read an account's saved watchlist. The website and MCP tool alphai_watchlist_brief use the caller's saved list instead.

hours is a publication-time window ending at generated_at, both ends inclusive. This is a ranked snapshot, not a delta since the last call. Bulk backfills are excluded. Within each section, the newest 500 matching articles at the configured relevance floor (default 4) are grouped, then ranked by each group's highest relevance and novelty, then its newest publication time. Fields on a returned event describe the representative article. limit applies independently to news and filings. Either a candidate overflow or additional grouped stories sets that section's *_truncated flag. A truncated response is a selection, not a complete event inventory; narrow hours or use the paginated ticker feed for further coverage.

An event shared by several requested tickers appears once, with matched_tickers naming all matches. If press coverage and a filing share a story, the filing represents it once in the filings section. Distinct Form 4 transaction legs remain separate even when they share a filing URL. Share classes and former ticker names are included. Unrecognized symbols are returned in unknown_tickers; bare crypto names are not guessed (use BTC-USD). Dates are confirmed only, on or after today's America/New_York date, excluding reports already matched to a published filing; absence means no confirmed date on file, not that no report is due. Available on every tier. Responses use Cache-Control: private, no-store.

get/api/news/brief/

Query parameters

tickersstring[] required

1–100 distinct symbols, comma-separated or repeated; case-insensitive.

hoursinteger
limitinteger

Maximum grouped stories in each section; this brief has no cursor.

Response

Brief with explicit coverage and truncation information.

generated_atstring date-time required
window_startstring date-time required
window_endstring date-time required
hoursinteger required
tickersstring[] required
unknown_tickersstring[] required
events_truncatedboolean
filings_truncatedboolean

Changes