Generated: 2026-05-24 (updated 2026-06-13 with Benzinga + Alpaca news). All articles fetched live from each provider's API. Module key for Unusual Whales CSV snapshots is
uw(renamed fromexternal_data).
| Provider | Module | Sentiment | Full Text | Source Quality | Auth |
|---|---|---|---|---|---|
| Alpaca News | alpaca_mktdata |
❌ | Title + summary | Medium (Reuters, Bloomberg, Benzinga) | ALPACA_API_KEY_PAPER (env var) |
| Benzinga | benzinga |
❌ | Summary (~200 chars) | High (finance-focused, ticker-tagged) | BEZINGA_API_KEY |
| NewsAPI.ai | newsapi_ai |
✅ float −1…1 | 300-char excerpt | High (Bloomberg, WSJ, FT, CNBC) | NEWSAPI_AI_KEY |
| FinViz | finviz |
❌ | Title only | High (Bloomberg, WSJ) | FINVIZ_API_TOKEN |
fmp |
❌ | Full article text | Mixed (PRNewswire heavy) | FMP_API_KEY |
|
gdelt |
❌ (separate call) | Title + domain | Variable, global, noisy | none | |
| NewsData.io | newsdata |
⚠️ paid plan only | 300-char excerpt | Low (filing bots) | NEWSDATA_API_KEY |
| NewsAPI.org | newsapi |
❌ | ~100-char desc | Medium (CNBC-heavy) | NEWSAPI_ORG_KEY |
| Articles | articles |
❌ | Full markdown | Very high (The Economist) | none (local files) |
benzinga_newsTool call: run_tool("benzinga_news", {"days": 3, "limit": 4})
Finance-specific news with mandatory ticker tagging. Every article is linked to one or more stock tickers, making it the most precise source for company-specific news filtering. No sentiment scores, but structured enough to use directly in reports.
Fields: id, title, author, date (YYYY-MM-DD), url, tickers (array), summary (~200 chars)
[
{
"title": "Nvidia Has Become An 'Infrastructure Company': Jensen Huang Shows Off RTX Spark Superchip And AI Factory Vision At Computex 2026",
"author": "Ananya Gairola",
"date": "2026-06-01",
"tickers": ["ARM", "DELL", "MSFT", "NVDA"],
"summary": "Nvidia CEO Jensen Huang used Computex 2026 to position the company beyond GPUs by unveiling the Vera CPU and RTX Spark superchip."
},
{
"title": "Dell Targets Students With Budget-Friendly XPS 13, Here's How The $599 Laptop Compares With Apple's MacBook Neo",
"author": "Ananya Gairola",
"date": "2026-06-01",
"tickers": ["AAPL", "DELL", "INTC"],
"summary": "Dell unveiled a lower-priced XPS 13 for students and budget buyers as it ramps up competition with Apple in the affordable laptop market."
},
{
"title": "Elizabeth Warren Says Trump's Iran War Is Costing Americans $800 Million A Day While Oil CEOs Get Richer",
"author": "Badar Shaikh",
"date": "2026-06-01",
"tickers": ["BKR", "COP", "CVX"],
"summary": "Elizabeth Warren criticizes Trump for causing excessive gas prices in the US, accuses oil executives of profiting from the Iran war."
}
]
Also available:
- benzinga_ratings({"ticker": "AAPL", "days": 30}) — analyst upgrades/downgrades with price targets
- benzinga_earnings_calendar({"days_ahead": 14}) — upcoming earnings with EPS estimates
- benzinga_guidance({"days": 30}) — company guidance vs prior guidance
- benzinga_dividends({"days_ahead": 30}) — dividend calendar
Note: Ticker filter is reliable and fast — use tickers=["AAPL"] to get only Apple-tagged articles. Source breadth is moderate (curated finance sites, not Bloomberg/WSJ tier) but editorial quality is consistent.
get_market_newsTool call: run_tool("get_market_news", {})
Returns up to 20 articles restricted to premium finance sources (Bloomberg, WSJ, FT, CNBC, Investing.com, Yahoo Finance). Each article includes a float sentiment score.
Fields: title, url, date (ISO 8601 UTC), source, source_uri, language, sentiment (−1.0 to +1.0), description (300 chars)
[
{
"title": "Hyperscaler Debt Flood Brings Derivatives Bonanza",
"source": "Bloomberg Business",
"source_uri": "bloomberg.com",
"date": "2026-05-23T19:00:00Z",
"sentiment": 0.2,
"description": "The surge in debt issuance from hyperscale cloud companies is creating a booming derivatives market as investors seek to hedge interest-rate exposure..."
},
{
"title": "Bulls push the S&P 500 back near records",
"source": "CNBC",
"source_uri": "cnbc.com",
"date": "2026-05-23T18:30:00Z",
"sentiment": 0.145,
"description": "Equities climbed for the third straight session as investors shrugged off lingering tariff concerns, bringing the S&P 500 within 1% of its all-time high..."
},
{
"title": "Trump's 3,711 Trades Point to Multiple Stock-Market Strategies",
"source": "Bloomberg Business",
"source_uri": "bloomberg.com",
"date": "2026-05-23T17:45:00Z",
"sentiment": 0.004,
"description": "An analysis of disclosed trading records reveals a range of equity positions held across family trusts and business entities..."
},
{
"title": "The World Loses Petrodollar Stimulus as Iran War Drains Gulf Wealth",
"source": "Bloomberg Business",
"source_uri": "bloomberg.com",
"date": "2026-05-23T16:00:00Z",
"sentiment": -0.122,
"description": "Gulf sovereign wealth funds are drawing down reserves to fund military spending, removing a key source of global liquidity that has supported asset prices..."
}
]
Also available: search_news({"q": "...", "max_items": N}) — open-web search without source restriction. Lower editorial quality, same fields.
newsTool call: run_tool("news", {"max_rows": 10})
Scrapes FinViz's news feed. Title-only (no description or sentiment). Consistently returns Bloomberg and WSJ as top sources.
Fields: Title, Source, Date (YYYY-MM-DD HH:MM:SS), Url, Category
[
{
"Title": "Trump's 3,711 Trades Point to Multiple Stock-Market Strategies",
"Source": "Bloomberg",
"Date": "2026-05-23 19:10:26",
"Category": "Market"
},
{
"Title": "Charting the Global Economy: Factory Activity Sags on Inflation",
"Source": "Bloomberg",
"Date": "2026-05-23 18:55:00",
"Category": "Market"
},
{
"Title": "Trump says deal with Iran to be announced soon",
"Source": "Yahoo Finance",
"Date": "2026-05-23 18:30:00",
"Category": "Market"
},
{
"Title": "ECB Hike May Be Inevitable to Keep Credibility, Stournaras Says",
"Source": "Bloomberg",
"Date": "2026-05-23 17:45:00",
"Category": "Market"
},
{
"Title": "Warsh's Fed 'Regime Change' May Require Patience, Consensus",
"Source": "Bloomberg",
"Date": "2026-05-23 17:20:00",
"Category": "Market"
},
{
"Title": "A Hot IPO Lifts Geothermal Power Companies",
"Source": "WSJ",
"Date": "2026-05-23 16:50:00",
"Category": "Market"
}
]
Note: FinViz also provides per-ticker news via ticker_news({"ticker": "AAPL"}).
get_newsTool call: run_tool("get_news", {"limit": 5})
Financial Modeling Prep returns ticker-tagged articles with full article text. Dominated by press releases and securities litigation notices from PRNewswire and Newsfile Corp.
Fields: symbol, publishedDate (YYYY-MM-DD HH:MM:SS), publisher, title, site, text (full body), image, url
[
{
"symbol": "GPK",
"publishedDate": "2026-05-23 19:30:00",
"publisher": "Newsfile Corp",
"title": "ROSEN, TOP RANKED INVESTOR COUNSEL, Encourages Graphic Packaging Holding Company Investors to Inquire About Securities Class Action Investigation",
"site": "newsfilecorp.com",
"text": "WHY: Rosen Law Firm, a global investor rights law firm, reminds purchasers of securities of Graphic Packaging Holding Company..."
},
{
"symbol": "SMCI",
"publishedDate": "2026-05-23 19:05:00",
"publisher": "PRNewsWire",
"title": "SMCI Deadline: SMCI Investors with Losses Encouraged to Contact Kessler Topaz",
"site": "prnewswire.com",
"text": "Kessler Topaz Meltzer & Check, LLP reminds investors of Super Micro Computer, Inc. that a securities class action lawsuit..."
},
{
"symbol": "FLYW",
"publishedDate": "2026-05-23 18:45:00",
"publisher": "MarketBeat",
"title": "Flywire CEO Touts Streamlining, AI Gains Amid Broader Fintech Headwinds",
"site": "marketbeat.com",
"text": "Flywire's chief executive highlighted the company's efforts to leverage artificial intelligence in its payments platform..."
},
{
"symbol": "PFL",
"publishedDate": "2026-05-23 18:20:00",
"publisher": "Seeking Alpha",
"title": "PFL: Downside Movement Was Overdone",
"site": "seekingalpha.com",
"text": "PIMCO Income Strategy Fund has seen its discount to NAV widen sharply over the past month, creating what we view as an attractive entry point..."
}
]
Note: FMP's get_news() without a ticker returns general market news. Use get_company_news({"ticker": "AAPL"}) for stock-specific articles.
search_gdelt_newsTool call: run_tool("search_gdelt_news", {"query": "financial markets", "max_records": 10})
GDELT ingests tens of thousands of global news sources in real time with no source quality filtering. Results include non-English sources, small regional outlets, and opinion blogs.
Fields: title, url, date (YYYYMMDDTHHmmssZ), domain, language, source_country
[
{
"title": "5 Best Long-Term Stocks to Buy Now for High Returns",
"domain": "insidermonkey.com",
"date": "20260523T230000Z",
"language": "English",
"source_country": "United States"
},
{
"title": "Trump Says Iran Peace Deal Is Near Completion",
"domain": "eurweb.com",
"date": "20260523T224500Z",
"language": "English",
"source_country": "United States"
},
{
"title": "Currency Conundrum",
"domain": "slguardian.org",
"date": "20260523T221500Z",
"language": "English",
"source_country": "Sri Lanka"
},
{
"title": "Crypto or Contraband? America's Regulatory War Over Securities and Commodities",
"domain": "opinionnigeria.com",
"date": "20260523T220000Z",
"language": "English",
"source_country": "Nigeria"
},
{
"title": "Global Markets Weekly Roundup — Taiwan Edition",
"domain": "twfinanceblog.com",
"date": "20260523T215000Z",
"language": "English",
"source_country": "Taiwan"
}
]
Sentiment (separate call): run_tool("get_gdelt_sentiment", {"query": "..."}) returns tone scores from GDELT's Global Knowledge Graph.
search_newsdataTool call: run_tool("search_newsdata", {"query": "stock market"})
Results are dominated by institutional ownership filing bots (13F announcements re-published as articles). Sentiment is plan-gated — returns a string placeholder on the current subscription.
Fields: title, url, date (YYYY-MM-DD HH:MM:SS), source, source_url, country (array), language, sentiment (string placeholder on current plan), description
[
{
"title": "UBS Group AG Raises Stock Position in Red Cat Holdings",
"source": "watchlistnews",
"source_url": "watchlistnews.com",
"date": "2026-05-23 11:26:57",
"country": ["united states of america"],
"language": "english",
"sentiment": "ONLY AVAILABLE IN PROFESSIONAL AND CORPORATE PLANS",
"description": "UBS Group AG lifted its position in shares of Red Cat Holdings, Inc. by 12.3% during the first quarter..."
},
{
"title": "Mizuho Markets Americas LLC Makes New $31.40 Million Investment in Micron",
"source": "tickerreport",
"source_url": "tickerreport.com",
"date": "2026-05-23 10:55:00",
"country": ["united states of america"],
"language": "english",
"sentiment": "ONLY AVAILABLE IN PROFESSIONAL AND CORPORATE PLANS",
"description": "Mizuho Markets Americas LLC acquired a new stake in Micron Technology during Q1, valued at approximately $31.4 million..."
}
]
Assessment: Mostly auto-generated 13F filing announcements, not editorial news. Source quality is significantly lower than NewsAPI.ai or FinViz on the current plan. Upgrading to Professional/Corporate plan would also unlock sentiment scores.
get_market_newsTool call: run_tool("get_market_news", {"page_size": 5})
Filtered to finance domains (cnbc.com, wsj.com, bloomberg.com, ft.com, reuters.com). On the current plan, results skew heavily toward CNBC. The unfiltered get_top_headlines({"category": "business"}) pulls general US headlines (off-topic for financial analysis).
Fields: title, source, author, date (ISO 8601), description, url
[
{
"title": "Qualcomm's stock pop shows investors are 'waking up' to boom in AI devices",
"source": "CNBC",
"author": "Kif Leswing",
"date": "2026-05-23T19:15:00Z",
"description": "Qualcomm shares surged after the chip designer reported strong earnings driven by demand for on-device AI processing in smartphones..."
},
{
"title": "Reddit stock drops 6% after Meta launches standalone app for online forums",
"source": "CNBC",
"author": "Jessica Bursztynsky",
"date": "2026-05-23T18:40:00Z",
"description": "Reddit shares fell sharply after Meta announced a new standalone communities app that would compete directly with Reddit's core product..."
},
{
"title": "Wall Street thinks IMAX is ripe for a sale",
"source": "CNBC",
"author": "Sarah Whitten",
"date": "2026-05-23T17:55:00Z",
"description": "Investment bankers and analysts say IMAX could attract interest from streaming giants or private equity as its valuation looks attractive..."
},
{
"title": "Which company will the U.S. government take a stake in next?",
"source": "CNBC",
"author": "Contessa Brewer",
"date": "2026-05-23T17:10:00Z",
"description": "After the U.S. took equity positions in airlines during the pandemic, analysts are watching for which sectors might be next..."
},
{
"title": "Microsoft's GitHub was positioned to win the AI coding race. Outages got in the way",
"source": "CNBC",
"author": "Jordan Novet",
"date": "2026-05-23T16:30:00Z",
"description": "A series of GitHub outages over the past months has frustrated developers who depend on the platform for AI-assisted coding..."
}
]
Tool call: run_tool("get_recent_articles", {"n": 5})
Locally stored Economist articles scraped and saved as markdown files in articles/. Full article text available. No API call — reads from disk.
Fields: title, date (YYYY-MM-DD), file, word_count, text (full markdown body)
[
{
"title": "UniCredits lowball bid for Commerzbank causes consternation",
"date": "2026-05-07",
"file": "2026-05-07 - UniCredits lowball bid for Commerzbank causes consternation.md",
"word_count": 847
},
{
"title": "The myth of the petrodollar",
"date": "2026-05-07",
"file": "2026-05-07 - The myth of the petrodollar.md",
"word_count": 912
},
{
"title": "Donald Trumps foreign policy gets a muscular finance arm",
"date": "2026-05-07",
"file": "2026-05-07 - Donald Trumps foreign policy gets a muscular finance arm.md",
"word_count": 763
},
{
"title": "DeepSeek and Alibaba rescue Chinas office landlords",
"date": "2026-05-07",
"file": "2026-05-07 - DeepSeek and Alibaba rescue Chinas office landlords.md",
"word_count": 798
},
{
"title": "Can Bill Ackman save the closed-end fund",
"date": "2026-05-05",
"file": "2026-05-05 - Can Bill Ackman save the closed-end fund.md",
"word_count": 934
}
]
Note: The archive covers roughly the past 3–4 weeks. Articles are scraped periodically — not real-time. Use list_articles({"limit": N}) for the index, get_recent_articles({"n": N}) to include full text.
get_alpaca_newsModule: tools/data_ingestion_alpaca_mktdata.py · Key: alpaca_mktdata
Agent wiring: news agent (via alpaca_mktdata:get_alpaca_news)
Auth: ALPACA_API_KEY_PAPER env var (no per-tenant TLS needed)
Alpaca's /v1beta1/news endpoint — aggregates articles from Reuters, Bloomberg, Benzinga, and other financial wires. Filterable by symbol(s). Results include title, summary, author, source, published timestamp, and URL.
Fields: headline, summary, author, source, created_at (ISO 8601), url, symbols (tickers mentioned)
Parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| symbols | array[string] | no | — | Filter to specific tickers (e.g. ["AAPL","NVDA"]). Omit for market-wide. |
| limit | integer | no | 20 | Max articles |
Assessment: Good supplementary source for breaking company and market news. Reuters/Bloomberg tier coverage without the NewsAPI.ai cost. No sentiment scores but pairs well with NewsAPI.ai's sentiment-weighted search. Best for quick company headline scan or when a symbol filter is needed alongside Benzinga.
| Use Case | Best Provider |
|---|---|
| Ticker-filtered company news | Benzinga (benzinga_news with tickers), Alpaca (get_alpaca_news with symbols) |
| Analyst upgrades/downgrades | Benzinga (benzinga_ratings) |
| Upcoming earnings + EPS estimates | Benzinga (benzinga_earnings_calendar) |
| Company guidance changes | Benzinga (benzinga_guidance) |
| Sentiment-weighted market news | NewsAPI.ai (get_market_news) |
| Quick headline scan, Bloomberg/WSJ | FinViz (news), Alpaca (get_alpaca_news) |
| Per-ticker news with full text | FMP (get_company_news) |
| Deep background, long-form analysis | Articles (get_recent_articles) |
| Earnings call transcripts | Articles (download_transcripts, get_transcript) |
| Broad global event monitoring | GDELT (search_gdelt_news) |
| US-focused breaking news (CNBC) | NewsAPI.org (get_market_news) |
| Institutional ownership filings | NewsData.io (search_newsdata) |