# Stock News & Equities Headlines (stock-news)

> Stock News & Equities Headlines (stock-news) is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-24).

Returns sentiment-tagged financial news headlines on stocks, earnings, IPOs, the Fed, and macro topics, sourced from GDELT with GNews fallback.

## Facts

- Endpoint: POST https://x402.agentutility.ai/stock-news?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stock-news-equities-headlines-stock-news-c06becbe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_u_8T4Cu1Onl3WXsKNwXWA

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 stock-news-equities-headlines-stock-news-c06becbe -d '<json body>'
```

Example prompt: Pull the top 10 stock market headlines from the last 48 hours using the stocks topic, and include sentiment — I want to see what's moving the market right now.

## When to prefer this

Choose this endpoint when you need fast, structured financial news headlines with sentiment covering stocks, earnings, IPOs, the Fed, or macro topics — especially when you want GDELT's broad public news corpus with a GNews fallback safety net, at a very low per-call cost of $0.005 USDC. Prefer it over generic news APIs when your use case is specifically financial/equities-focused and you need preset topic filtering without building your own query logic.

## Known failure modes

- Invalid topic enum value returns a validation error
- Hours outside 1-168 range rejected
- Query string exceeding 240 characters truncated or rejected
- GNews fallback may return fewer results if GDELT data is sparse
- Payment failure (insufficient USDC) returns 402 before processing
- Limit values outside 1-30 range rejected

## How this service works

Stock news / equities headlines (alias of stocks-news). GDELT-backed public news with a GNews fallback when configured on stocks, earnings, IPOs, the Fed, and macro with sentiment. Buyer-wording variant of stocks-news. Data-only; no trading advice.

## Output

A JSON object containing the topic queried, the data source used (GDELT or GNews), the number of headlines returned, and an array of news headlines with associated sentiment data for the specified financial topic and time window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {
      "hours": {
       "type": "number",
       "description": "Lookback window in hours, 1-168. Default 48."
      },
      "limit": {
       "type": "number",
       "description": "Headlines to return, 1-30. Default 10."
      },
      "query": {
       "type": "string",
       "description": "Optional news query override, max 240 chars."
      },
      "topic": {
       "enum": [
        "stocks",
        "earnings",
        "ipos",
        "fed",
        "macro",
        "tech"
       ],
       "type": "string",
       "description": "Preset topic. Default stocks."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "topic": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "returned": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "topic": "stocks",
  "source": "GDELT 2.1 Document API",
  "returned": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stock-news-equities-headlines-stock-news-c06becbe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)