# Alpha Vantage News Sentiment via Locus x402

> Alpha Vantage News Sentiment via Locus x402 is a paid API for AI agents from alphavantage.x402.paywithlocus.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Fetches financial news articles with sentiment scores for specific stock tickers and/or topics, with filtering by time range and sorting options, billed per-call via USDC micropayment.

## Facts

- Endpoint: POST https://alphavantage.x402.paywithlocus.com/alphavantage/news-sentiment
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/alpha-vantage-news-sentiment-via-locus-x402-71a2fa5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xn720-E5RV1uOvbaRYiWo

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-via-locus-x402-71a2fa5b -d '<json body>'
```

Example prompt: Pull the 50 most recent news articles for AAPL and MSFT from Alpha Vantage and include sentiment scores — sorted by latest, from the past week.

## When to prefer this

Choose this endpoint when you need structured news sentiment data tied to specific stock tickers or financial topics, with built-in NLP sentiment scoring from Alpha Vantage. Prefer it over generic news APIs when you need finance-specific topic classification (earnings, IPO, M&A, etc.) and per-ticker sentiment breakdowns. The pay-per-call USDC pricing via x402 makes it cost-effective for sporadic lookups without a subscription.

## Known failure modes

- Invalid ticker symbol returns empty or error result
- Malformed time_from/time_to format (must be YYYYMMDDTHHMM) causes API rejection
- Exceeding limit of 1000 results causes validation error
- Payment failure or insufficient USDC balance prevents call from completing
- No results returned for very narrow time windows or obscure tickers
- Rate limiting from underlying Alpha Vantage API may cause intermittent failures

## How this service works

Financial market data — stock prices, forex, crypto, commodities, economic indicators, technical analysis, and news sentiment.

## Output

Returns a JSON payload containing a list of news articles with their titles, sources, publication times, URLs, summary text, overall sentiment scores (positive/negative/neutral), topic relevance scores, and per-ticker sentiment breakdowns. Also includes payment confirmation details showing settled USDC amount.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string"
  },
  "limit": {
   "type": "number"
  },
  "topics": {
   "type": "string"
  },
  "tickers": {
   "type": "string"
  },
  "time_to": {
   "type": "string"
  },
  "time_from": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "payment": {
   "scheme": "exact",
   "settledUsdc": "0.001000",
   "authorizedMaxUsdc": "0.001000"
  },
  "request": {
   "id": "00000000-0000-4000-8000-000000000000",
   "statusUrl": "/requests/00000000-0000-4000-8000-000000000000"
  },
  "success": true
 }
}
```

## More

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