News Sentiment

Whether the financial-news headlines on a stock are positive or negative — AI-scored, with links.

GET/api/news
Market IntelligenceIncluded in every plan · one key.

Overview

Recent financial-news headlines for any US ticker from TradingKey, MarketBeat, MarketScreener and Yahoo Finance fallback feeds. Each headline is read by an AI model and scored bullish/bearish/neutral, with source/provider, links, publishers and dates, plus `bullSummary`/`bearSummary` recaps. The response exposes `providerStatus` so a temporarily blocked or empty source is visible instead of silently disappearing. Cached ~30 min.

Use it toCheck whether the news flow on a stock is positive or negative — the press angle, not social.

Coverage

Universe
Any US-listed ticker
History
Recent headlines
Updates
On demand · ~30 min cache
Source
TradingKey + MarketBeat + MarketScreener + Yahoo fallback + DeepSeek

Call it

Send your ra_live_… key in the x-api-key header. Pick your language:

curl "https://raspberrytrades.com/api/news?ticker=NVDA" \
  -H "x-api-key: ra_live_your_key_here"

Parameters

ParameterTypeDescription
tickerstringUS stock symbol, e.g. NVDA (required)
fresh0 | 11 = bypass the 30-min cache (optional)
x-api-keyheaderYour API key — news scope (required)
Example response
200 OK · application/json
{
  "ticker": "NVDA",
  "updatedAt": "2026-07-01T14:00:00Z",
  "source": "multi-source",
  "sources": ["tradingkey", "marketbeat", "marketscreener", "yahoo-finance"],
  "providerStatus": [
    { "provider": "tradingkey", "status": "ok", "count": 4 },
    { "provider": "marketbeat", "status": "ok", "count": 3 },
    { "provider": "marketscreener", "status": "ok", "count": 2 },
    { "provider": "yahoo-finance", "status": "ok", "count": 11 }
  ],
  "count": 20,
  "sentiment": { "label": "bullish", "score": 0.34, "bullish": 13, "bearish": 2, "neutral": 5 },
  "bullSummary": "Coverage highlights AI-chip demand and new design wins.",
  "bearSummary": "A few pieces flag valuation and competition risk.",
  "headlines": [
    {
      "title": "Nvidia extends AI lead with new datacenter deal",
      "summary": "The chipmaker announced…",
      "url": "https://www.reuters.com/...",
      "source": "reuters.com",
      "provider": "marketbeat",
      "publishedAt": "2026-07-01T11:20:00Z",
      "sentiment": "bullish"
    }
  ]
}
Market Intelligence — related datasets
Get your API key

Create a free account, copy your ra_live_… key and make your first call to https://raspberrytrades.com/api/news.

Keep your key on your server — never ship it in front-end code.