# x402stock News Sentiment

> x402stock News Sentiment is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402 or MPP, $0.02/call, status unknown (last checked 2026-09-14).

Returns market news sentiment data for stocks, ETFs, crypto, and other financial instruments, paid per request via USDC

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/news-sentiment
- Price: $0.02/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-news-sentiment-9847e689
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VcIWm69uAJyanJFvo6jyp

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 x402stock-news-sentiment-9847e689
```

Example prompt: What's the current news sentiment for AAPL — is the market leaning bullish or bearish based on recent headlines?

## When to prefer this

Choose this endpoint when an AI agent needs real-time or recent news sentiment signals for financial assets (stocks, ETFs, crypto) without requiring API keys or account setup. It is ideal for autonomous agents that can pay per request in USDC via x402 or MPP, especially when integrating sentiment into trading signals, portfolio decisions, or market monitoring workflows. Prefer this over subscription-based sentiment providers when low-volume, pay-as-you-go access is sufficient.

## Known failure modes

- Invalid or unsupported ticker symbol returns empty or error response
- Payment failure via x402/MPP results in 402 Payment Required response
- Rate limiting or quota exhaustion may return 429 or payment-related errors
- Missing or malformed query parameters return 400 Bad Request
- No recent news available for an asset returns empty sentiment result

## How this service works

Global news attention and tone for any company, ticker, or topic, from the GDELT Project's worldwide news monitoring. Pass `?q=Nvidia` (required), `?timespan=1d|3d|1w|2w|1m|3m` (default 1w). Returns average and latest tone with a positive/neutral/negative label and trend, an article-volume timeline, and recent headlines. A media-sentiment read distinct from the Reddit/4chan feeds. From x402stock

## Output

Returns sentiment analysis derived from recent financial news, including sentiment scores (bullish/bearish/neutral signals) and related news indicators for the queried asset or market topic. Delivered as structured JSON at $0.02 USDC per call with no API key required.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-news-sentiment-9847e689/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)