# AgentUtility Stocks News API

> AgentUtility Stocks News API is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches recent stock market news headlines on equities, earnings, IPOs, Fed policy, and macro topics from GDELT with GNews fallback, returning headline metadata with sentiment and source domains.

## Facts

- Endpoint: POST https://x402.agentutility.ai/stocks-news
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-stocks-news-api-b4ee7aae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4QIe--s1nCOKtB9tUzQ-O

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 agentutility-stocks-news-api-b4ee7aae -d '<json body>'
```

Example prompt: Pull the latest 10 earnings news headlines from the stocks news feed, including sentiment and source info — I want to see what's moving markets around earnings season right now.

## When to prefer this

Choose this endpoint when an agent needs a structured, low-cost news digest specifically for equities, earnings, IPOs, Fed policy, or macro topics with sentiment metadata attached. It is the stock market analog to a crypto news feed, optimized for financial agent workflows that need headline-level awareness rather than price data or trading signals. Prefer it over general web search when you want structured JSON with sentiment and source provenance already computed, and when you want GDELT's broad media coverage with a fallback source.

## Known failure modes

- GDELT API unavailable and GNews fallback not configured — returns empty or error response
- Topic parameter not recognized — may return irrelevant or zero results
- Rate limiting or x402 payment failure — request rejected with payment required error
- Stale data if GDELT indexing is delayed — headlines may lag by minutes to hours

## How this service works

Fetches recent stock market news on equities, earnings, IPOs, the Fed, and macro from GDELT with a GNews fallback when configured, returning headline metadata with sentiment and source domains. The equities companion to crypto-news. Data-only news digests; no price prediction, trading advice, or order routing. Use it as a stocks news API, equities news feed, earnings news source, or Wall Street headlines for agents.

## Output

A JSON object containing the topic queried, the data source used (GDELT 2.1 or GNews), and an array of headline metadata records including article titles, publication timestamps, sentiment scores, and source domain names, with a count of results returned.

## 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 (e.g. a ticker or company), 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": "earnings",
  "source": "GDELT 2.1 Document API",
  "returned": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-stocks-news-api-b4ee7aae/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)