# Alpha Vantage News Sentiment

> Alpha Vantage News Sentiment is a paid API for AI agents from Alpha Vantage at alphavantage.mpp.paywithlocus.com, paid per call via MPP, $0.008/call, status unknown (last checked 2026-10-10, last successful call 2026-06-16).

Retrieves news articles with sentiment scores for specific stock tickers and/or financial topics within a given time range

## Facts

- Endpoint: POST https://alphavantage.mpp.paywithlocus.com/alphavantage/news-sentiment?utm_source=zero.xyz
- Price: $0.008/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-10
- Last successful call: 2026-06-16
- Success rate: 50% of calls made through Zero
- Activations on Zero: 6
- Provider: Alpha Vantage
- Docs: https://www.alphavantage.co/documentation/
- Website: https://www.alphavantage.co
- Tags: finance, stocks, forex, crypto, market-data, technical-analysis, data
- Canonical page: https://www.zero.xyz/c/alpha-vantage-news-sentiment-3fbebe6b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1k3-_bOWp0dtT8z-B3YjA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability alpha-vantage-news-sentiment-3fbebe6b -d '<json body>'
```

Example prompt: Pull the 20 most recent news articles for AAPL and MSFT from January 2024, sorted by latest, and give me the sentiment scores — I want to see if the coverage was mostly bullish or bearish going into earnings.

## When to prefer this

Use this endpoint when you need structured, sentiment-annotated financial news specifically tied to stock tickers or financial topics, as opposed to raw news feeds. Ideal for agents building trading signals, monitoring brand sentiment for public companies, or tracking macro themes like IPOs or monetary policy in the news.

## Known failure modes

- Invalid ticker symbol returns empty or error response
- Malformed time format (not YYYYMMDDTHHMM) causes a 400 error
- Requesting limit above 1000 may be capped or rejected
- Empty result set if no news exists for the given filters in the time range
- Rate limiting if too many requests are made in quick succession

## How this service works

Live and historical market news with AI-powered sentiment scores. Filter by tickers and topics.

## Output

A list of news articles (up to 1000) each annotated with overall sentiment scores and labels (bullish/bearish/neutral), per-ticker relevance and sentiment, topic tags, source metadata, and publication timestamps — filtered by the specified tickers, topics, and time window.

## Example request

```json
{
 "sort": "LATEST",
 "limit": 10,
 "tickers": "AAPL,MSFT",
 "time_to": "20240131T2359",
 "time_from": "20240101T0000"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string",
   "description": "\"LATEST\", \"EARLIEST\", or \"RELEVANCE\" (default \"LATEST\")"
  },
  "limit": {
   "type": "number",
   "description": "Number of results (default 50, max 1000)"
  },
  "topics": {
   "type": "string",
   "description": "Comma-separated topics: blockchain, earnings, ipo, mergers_and_acquisitions, financial_markets, economy_fiscal, economy_monetary, economy_macro, energy_transportation, finance, life_sciences, manufacturing, real_estate, retail_wholesale, technology"
  },
  "tickers": {
   "type": "string",
   "description": "Comma-separated ticker symbols (e.g., \"AAPL,MSFT\" or \"CRYPTO:BTC,CRYPTO:ETH\")"
  },
  "time_to": {
   "type": "string",
   "description": "End time in YYYYMMDDTHHMM format"
  },
  "time_from": {
   "type": "string",
   "description": "Start time in YYYYMMDDTHHMM format (e.g., \"20220410T0130\")"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-news-sentiment-3fbebe6b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alphavantage.mpp.paywithlocus.com](https://www.zero.xyz/host/alphavantage.mpp.paywithlocus.com/llms.txt)