News & Sentiment

What's inside#

• Live newswire. Cross-publisher headlines with publisher, tickers, an is_major flag and feed-supplied sentiment, seconds-to-minutes fresh.
• Newswire stories and explainers. Full newswire stories by ticker or channel with history back to 2018, "Why It's Moving" explainers with a catalyst type, the movers channel, company press releases and the crypto channel.
• Per-ticker news. A one-call digest (recent stories, sentiment, trending status, events and analyst actions), raw headlines over a short window, company-only coverage, co-mention feeds and a full filtered search.
• Market-wide news. Aggregated cross-source feed, category and topic feeds on the news source's own categories (earnings, M&A, dividends, layoffs, lawsuits and more), headline-only alerts and an end-of-day digest.
• Events. Detected market-moving events, structured events by type, and every article clustered under one event id.
• Sentiment. Daily sentiment per ticker (-1.5 to +1.5), market-wide rollups, most-mentioned tickers, and a deep daily sentiment history per company from 2000.
• Analysts. Consensus rating with price-target bands, and rating actions (upgrades, downgrades, initiations) back to 2022-04-08.
• Social attention. A daily Twitter follower count with its weekly percent change per ticker. There is no mention count, and the upstream dataset was found returning no rows for any ticker in July 2026 (see the notes below).

Crypto news with sentiment is on the Crypto page and FX news is on Macro, Rates & FX. The r/wallstreetbets feed is part of Alt-Data.

Access#

Which endpoint to call#

• "What's the news on X?" Start with GET /api/v3/news/summary/{ticker}. It answers most single-ticker questions in one call. Reach for the drill-down routes (news/latest, news/trending) only when the summary is not enough.
• "What's happening in the market right now?" GET /api/v3/intel/news_headlines (fastest wire) or GET /api/v3/news/aggregated.
• "Why is X moving today?" GET /api/v3/intel/news_why_moving?tickers=X. For "what moved today", GET /api/v3/intel/news_movers.
• "Did anything big happen today?" GET /api/v3/news/events or GET /api/v3/news/curated_events.
• News with filters (topic, source, sentiment, keyword): GET /api/v3/news/ticker_news. For sector or industry news, GET /api/v3/news/category.
• "Headlines on X in the last few hours": GET /api/v3/news/aggregated?ticker=X&hours=N.
• How sentiment is trending: GET /api/v3/news/sentiment_stats for recent days, GET /api/v3/news/sentiment_history/{ticker} for years.

Endpoints#

date_range on the newswire routes accepts today, yesterday, last7days, last30days, or a custom MMDDYYYY-MMDDYYYY window (sentiment_stats also takes last60days). items is the page size and page the page number where a route paginates.

One ticker#

Market-wide news#

Newswire stories#

Five routes over the newswire, live, newest first. Each item carries id, title, teaser, url, tickers, channels and tags (lower case), published (UTC) and updated; body=true adds the full HTML body. date_from and date_to (UTC days, inclusive, at most 366 days apart) read past windows back to 2018. An empty list is a real empty answer (result: "empty_but_healthy"); a feed that did not answer is a 503 refusal, never an empty list. Quote each story with its time.

News topics#

topic on by_topic and category, and topic, topic_or and topic_exclude on ticker_news, take the news source's own categories. Case does not matter.

• earnings, dividend (or dividends), layoffs, lawsuit, product, ceo, podcast, oil, futures.
• mergers for M&A. acquisition, acquisitions, mergers_acquisitions, m&a and manda mean the same; all are sent as manda.
• pricemovement (or price_movement), tanalysis for technical analysis (or technical_analysis), and pressrelease (or press_release).
• The access tags paywall and paylimitwall, most useful in topic_exclude to drop paywalled articles.

Anything else returns 422 with error: "invalid_topic", and detail names the supported topics; the source is not called and the call is not billed. That includes ipo, fda, analysts, pricetarget, guidance, stock_buyback, stocksplit, partnership, spinoff, bankruptcy, insider, esg and crypto, which this page used to list. The source has no such category, so they always answered an empty list, which read as "no news"; the 422 now says there is no such category. For those subjects use search on ticker_news, and news/ratings for analyst actions.

by_topic echoes your word in topic and the category it sent in source_topic: topic=mergers answers topic: "mergers" and source_topic: "manda". category echoes your word in topic.

Events and catalysts#

Sentiment#

Analysts#

The ratings calendar, GET /api/v3/intel/calendar/ratings on Macro, Rates & FX, reads the same live ratings feed as news/ratings and adds each action's price-target move (action_pt), derived from the prior and current targets, with action and date filters. Until 2026-09-25 it served an archive that ended on 2026-06-26.

Social attention#

Coverage and freshness notes.

• A filter a route does not take is refused, never dropped. On every /api/v3/news/*, /api/v3/intel/news_*, /api/v3/news_crypto/* and /api/v3/news_forex/* route, a non-blank ticker, tickers, symbol, symbols, sector, sectors, industry, topic or topics that the route does not declare (and, on news_forex, pair, pairs, currency or currencies) answers 422 with error: "unsupported_filter", not billed. detail names the parameter or route to use instead, unsupported lists the refused names and accepted the route's own parameters. Before this, such a filter was silently dropped and the unfiltered answer was served as if filtered. Any other unknown parameter is still ignored.
• Newswire routes are read-through caches with short lifetimes (30 s for alerts, 60 s for news/latest, 90 s for news/summary, 120 s for intel/news_headlines, up to 10 minutes for rollups), so the same call inside that window returns the same payload.
• When the news feed fails and returns nothing, the /api/v3/news/* routes answer 503 with error: "upstream_unavailable", not billed, instead of a 200 with an empty list. error_code names the failure (upstream_quota_exhausted, upstream_http_error, upstream_not_configured and so on), upstream_error summarises it, and Retry-After says when to retry. The body has no items field. A feed that answered with nothing is still a 200 with an empty list, and a partial failure keeps its rows beside a vendor_error block. news/summary refuses this way when its sub-calls come back empty while the feed's quota is exhausted. When the feed is out of quota and states when its quota resets, upstream_error adds quota_resets_at (UTC) and quota_resets_at_basis (the feed names no time zone; its time is read as New York time), and the body adds retry_after_basis: "firm_recheck": Retry-After is when Wealthnow next checks the feed, within the hour, not when the quota returns. Until quota_resets_at, or a plan change at the source, expect the same refusal.
• sentiment_history stitches a news-analytics archive (2000 to 2025-12-31) with the live feed from 2026. It keys the archive by the resolved company's name, so identity_verified is always false; if the name cannot be resolved you get error: "entity_unmatched" and can pass entity to override. With no matching rows the response carries warning: "no_rows". When the archive or the live feed cannot be read, it answers 503 with error: "upstream_unavailable" and error_code: "warehouse_read_failed", not billed, never an empty series.
• The rating-actions feed behind recent_actions on analyst_consensus is retired (no data after 2026-06-30). recent_actions is empty, recent_actions_source_status is source_retired, and the price-target band comes from the fallback sources named in pt_band_source_status. news/ratings and, since 2026-09-25, the ratings calendar read a different, live feed; use them for rating actions.
• The upstream Twitter dataset returned no rows for any ticker when checked on 2026-07-02 and 2026-09-24, and the route has no fallback source. While that lasts, intel/twitter answers 503 upstream_dataset_empty rather than an empty list. It does not mean the ticker had no followers or attention.

Examples#

Example 1: One call for a ticker's news (bash)#

curl -H "Authorization: Bearer $WEALTHNOW_API_KEY" \  "https://firm.wealthnow.io/api/v3/news/summary/AAPL" # Response:# {#   "ok": true,#   "timestamp": "2026-09-24T14:05:11Z",#   "ticker": "AAPL",#   "recent_news": [#     {#       "title": "Apple shares rise after supplier raises its outlook",#       "text": "Shares of Apple rose after ...",#       "news_url": "https://...",#       "source_name": "...",#       "date": "Thu, 24 Sep 2026 09:41:00 -0400",#       "sentiment": "Positive",#       "tickers": ["AAPL"]#     }#   ],#   "sentiment_stats": { ... },   # 7-day daily rollup, same shape as news/sentiment_stats#   "trending": [ ... ],#   "events": [ ... ],            # 7-day structured events#   "analyst_actions": [ ... ],   # 7-day upgrades / downgrades / initiations#   "news_count_24h": 18# }

Example 2: Market-wide headlines (bash)#

intel/news_headlines is the market-wide wire. Leave ticker off for a market sweep.

curl -H "Authorization: Bearer $WEALTHNOW_API_KEY" \  "https://firm.wealthnow.io/api/v3/intel/news_headlines?limit=10" # Response:# {#   "ok": true,#   "timestamp": "2026-09-24T14:06:02Z",#   "ticker": null,#   "items": [#     {#       "headline": "Treasury yields climb ahead of the jobs report",#       "publisher": "...",#       "created_at": "2026-09-24T14:04:37Z",#       "tickers": [],#       "is_major": true,#       "sentiment": "neutral",#       "tags": []#     }#   ],#   "count": 10,#   "as_of": "2026-09-24T14:06:02Z",#   "source": "vendor:options-flow"# }

Example 3: Filtered search and daily sentiment (Python)#

import os, requests HEADERS = {"Authorization": f"Bearer {os.environ['WEALTHNOW_API_KEY']}"}BASE = "https://firm.wealthnow.io" # Negative earnings coverage on two names over the last weekr = requests.get(    f"{BASE}/api/v3/news/ticker_news",    params={"tickers": "NVDA,AMD", "topic": "earnings",            "sentiment": "negative", "date_range": "last7days", "items": 20},    headers=HEADERS, timeout=30,)r.raise_for_status()data = r.json()  # {"ok": true, "timestamp": ..., "tickers": ["NVDA", "AMD"], "items": [...], "n": 20}for item in data["items"][:5]:    print(item["date"], item["source_name"], item["title"]) # Daily sentiment for one ticker: outer keys are dates, inner keys are tickersr = requests.get(    f"{BASE}/api/v3/news/sentiment_stats",    params={"ticker": "NVDA", "date_range": "last7days"},    headers=HEADERS, timeout=30,)r.raise_for_status()stats = r.json()["stats"]# stats["data"] == {"2026-09-23": {"NVDA": {"Positive": 14, "Negative": 3,#                                           "Neutral": 9, "sentiment_score": 0.42}}, ...}for day, by_ticker in sorted(stats.get("data", {}).items()):    row = by_ticker.get("NVDA")    if row:        print(day, row["sentiment_score"])

Example 4: Daily sentiment through the 2008 crisis (Python)#

import os, requests r = requests.get(    "https://firm.wealthnow.io/api/v3/news/sentiment_history/MSFT",    params={"start": "2008-01-01", "end": "2009-12-31", "min_relevance": 90, "limit": 1000},    headers={"Authorization": f"Bearer {os.environ['WEALTHNOW_API_KEY']}"},    timeout=60,)r.raise_for_status()data = r.json()# {#   "ok": true,#   "ticker": "MSFT",#   "entity_names": ["MICROSOFT CORP"],#   "start": "2008-01-01", "end": "2009-12-31",#   "min_relevance": 90.0,#   "n": 498,#   "rows": [{"date": "2008-01-02", "ess_mean": 0.21, "n_events": 12, "relevance_mean": 97.5}, ...],#   "identity": {...},#   "identity_verified": false,#   "source": "warehouse:news-analytics-archive"# }worst = min(data["rows"], key=lambda row: row["ess_mean"])print("Most negative day:", worst["date"], worst["ess_mean"])

Example 5: Analyst consensus and recent rating actions (Python)#

recent_actions on analyst_consensus is empty because its source feed is retired (recent_actions_source_status: "source_retired"), so read rating actions from news/ratings.

import os, requests HEADERS = {"Authorization": f"Bearer {os.environ['WEALTHNOW_API_KEY']}"}BASE = "https://firm.wealthnow.io" r = requests.get(f"{BASE}/api/v3/intel/analyst_consensus/AAPL", headers=HEADERS, timeout=30)r.raise_for_status()data = r.json()  # envelope: {"ok": true, "timestamp": "...", "consensus": {...}, "pt_band_source_status": "...", ...}c = data["consensus"]print(f"{c['rating_label']} (score {c['rating_score']}, {c['total_analysts']} analysts)")print(f"Price target {c['price_target_low']} to {c['price_target_high']}, "      f"avg {c['price_target_avg']}, source: {data['pt_band_source_status']}") r = requests.get(    f"{BASE}/api/v3/news/ratings",    params={"tickers": "AAPL", "date_range": "last30days", "items": 5},    headers=HEADERS, timeout=30,)r.raise_for_status()for action in r.json()["items"]:    print(action)

Related#