# x402stock News

> x402stock News 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-10-12).

Fetches financial and market news relevant to stocks, ETFs, crypto, commodities, and macro topics, paid per request via USDC through x402

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/news?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402, MPP
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-news-2feacdc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iJPfgW1vgf1_PgPBEqcel

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-2feacdc7
```

Example prompt: Pull the latest news headlines for NVDA from x402stock so I can see what's driving the stock today.

## When to prefer this

Use this endpoint when an AI agent needs current financial news, market headlines, or sentiment signals for a specific stock ticker, asset class, or macro topic and is operating in a pay-per-use, keyless context via x402. Prefer this over scrapers or general web search when structured, finance-focused news with reliable sourcing is needed without API key management.

## Known failure modes

- Payment failure if USDC balance is insufficient — returns 402 Payment Required
- Invalid or unsupported query parameters — returns 400 Bad Request
- No news found for the given parameters — returns empty result set
- Rate limiting or proxy error from upstream — returns 429 or 502
- Network timeout if upstream news provider is slow

## How this service works

Curated stock-market news with ticker tags, source, publisher, image, and timestamps. Pass `?ticker=AAPL` to filter. From x402stock, a pay-per-call market & economic data API for AI agents. No API key or account; pay in USDC via x402.

## Output

Returns a collection of financial news articles or headlines relevant to the queried asset or topic, including article titles, publication timestamps, source attribution, and summary content, enabling agents to assess recent market developments and sentiment.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "count",
  "articles"
 ],
 "properties": {
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "articles": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "title",
     "description",
     "url",
     "image_url",
     "author",
     "publisher",
     "publisher_homepage",
     "published_at",
     "tickers",
     "keywords"
    ],
    "properties": {
     "id": {
      "type": "string"
     },
     "url": {
      "type": "string"
     },
     "title": {
      "type": "string"
     },
     "author": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "tickers": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "keywords": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "image_url": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "publisher": {
      "type": "string"
     },
     "description": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "published_at": {
      "type": "string"
     },
     "publisher_homepage": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-news-2feacdc7/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)