# x402stock Stock News Feed

> x402stock Stock News Feed is a paid API for AI agents from x402stock.vercel.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Fetches the latest US stock market news articles, including headlines, tickers, and metadata, for one or more stock symbols, paid per-request in USDC via x402.

## Facts

- Endpoint: GET https://x402stock.vercel.app/api/v1/news
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-stock-news-feed-fd7f9663
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v9oD6HnwXT--x9xmzlR4N

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-stock-news-feed-fd7f9663
```

Example prompt: Pull the latest news articles for AAPL and NVDA — I want the headlines, publisher names, and any keywords tagged to each story.

## When to prefer this

Use this endpoint when you need structured, machine-readable news articles tied to specific US stock tickers, with per-article metadata (author, publisher, keywords, image) and no subscription required. Prefer it over general web search when you want clean JSON output scoped to equity-relevant news, especially in agent workflows that need to correlate news with price or fundamental data from the same x402stock suite.

## Known failure modes

- Payment not made or USDC balance insufficient — 402 Payment Required response
- Invalid or unrecognized ticker symbol — empty articles array or 400 error
- No recent news available for the requested ticker — count: 0 with empty articles array
- Rate limiting or upstream news source unavailability — 503 or timeout

## How this service works

US stock prices, snapshots, OHLC bars, fundamentals, corporate actions, technical indicators and news for AI agents. No API keys. No accounts. Pay per request in USDC via x402.

## Output

A JSON object containing an as_of timestamp, article count, source attribution, and an array of news articles each with id, URL, title, author, associated ticker symbols, keywords, image URL, publisher name and homepage, description snippet, and published_at timestamp.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-05-29T20:00:00.000Z",
  "count": 1,
  "source": "massive",
  "articles": [
   {
    "id": "abc123",
    "url": "https://example.com/news/apple-high",
    "title": "Apple reaches new all-time high",
    "author": "Jane Reporter",
    "tickers": [
     "AAPL"
    ],
    "keywords": [
     "earnings",
     "services"
    ],
    "image_url": "https://example.com/img/apple.jpg",
    "publisher": "Example Wire",
    "description": "Shares climbed on strong services revenue.",
    "published_at": "2026-05-29T12:00:00Z",
    "publisher_homepage": "https://example.com"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-stock-news-feed-fd7f9663/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402stock.vercel.app](https://www.zero.xyz/host/x402stock.vercel.app/llms.txt)