# Stock News

> Stock News is a paid API for AI agents from agent.massive.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Retrieves the most recent news articles for a given stock ticker symbol, including article summaries and source links

## Facts

- Endpoint: GET https://agent.massive.com/v2/reference/news
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stock-news-c6beded3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Z6_OW0G8z_s4aP3H69SgN

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-c6beded3
```

Example prompt: Pull the 10 most recent news articles for NVDA, sorted by published date descending, so I can see what's driving the stock today.

## When to prefer this

Use this endpoint when you need current or recent news articles tied to a specific stock ticker symbol, especially when you also need filtering by date range or control over result count and ordering. Prefer this over general web search when you want structured, finance-specific news with summaries and source links, and when you are operating within a stock analysis or financial monitoring workflow alongside sibling endpoints like price data or insider filings.

## Known failure modes

- Invalid or unrecognized ticker symbol returns empty results or error
- Case-sensitive ticker mismatch causes no results (e.g. 'aapl' instead of 'AAPL')
- Date filter parameters in wrong format return errors
- Limit value outside 1–1000 range causes validation error
- No recent news available for obscure tickers returns empty result set
- Payment failure or insufficient USDC balance blocks the request

## How this service works

Get the most recent news articles relating to a stock ticker symbol, including a summary of the article and a link to the original source. Can't find what you're looking for? POST feedback to /feedback, no charge.

## Output

Returns a list of news articles relevant to the specified stock ticker, each including an article summary, a link to the original source, and publication date metadata. Results can be filtered by date range and ordered by publication time, with up to 1000 results per call.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "sort": {
       "enum": [
        "published_utc"
       ],
       "type": "string",
       "default": "published_utc",
       "description": "Sort field used for ordering."
      },
      "limit": {
       "type": "integer",
       "default": 10,
       "maximum": 1000,
       "minimum": 1,
       "description": "Limit the number of results returned, default is 10 and max is 1000."
      },
      "order": {
       "enum": [
        "asc",
        "desc"
       ],
       "type": "string",
       "default": "desc",
       "description": "Order results based on the `sort` field."
      },
      "ticker": {
       "type": "string",
       "description": "Specify a case-sensitive ticker symbol. For example, AAPL represents Apple Inc."
      },
      "ticker.gt": {
       "type": "string",
       "description": "Search by ticker."
      },
      "ticker.lt": {
       "type": "string",
       "description": "Search by ticker."
      },
      "ticker.gte": {
       "type": "string",
       "description": "Search by ticker."
      },
      "ticker.lte": {
       "type": "string",
       "description": "Search by ticker."
      },
      "published_utc": {
       "type": "string",
       "description": "Return results published on, before, or after this date."
      },
      "published_utc.gt": {
       "type": "string",
       "description": "Search by published_utc."
      },
      "published_utc.lt": {
       "type": "string",
       "description": "Search by published_utc."
      },
      "published_utc.gte": {
       "type": "string",
       "description": "Search by published_utc."
      },
      "published_utc.lte": {
       "type": "string",
       "description": "Search by published_utc."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "status": "OK",
  "results": [
   {
    "id": "8ec638777ca03b553ae516761c2a22ba2fdd2f37befae3ab6fdab74e9e5193eb",
    "title": "Markets are underestimating Fed cuts: UBS By Investing.com - Investing.com UK",
    "author": "Sam Boughedda",
    "amp_url": "https://m.uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968?ampMode=1",
    "tickers": [
     "UBS"
    ],
    "insights": [
     {
      "ticker": "UBS",
      "sentiment": "positive",
      "sentiment_reasoning": "UBS analysts are providing a bullish outlook on the extent of future Federal Reserve rate cuts, suggesting that markets are underestimating the number of cuts that will occur."
     }
    ],
    "keywords": [
     "Federal Reserve",
     "interest rates",
     "economic data"
    ],
    "image_url": "https://i-invdn-com.investing.com/news/LYNXNPEC4I0AL_L.jpg",
    "publisher": {
     "name": "Investing.com",
     "logo_url": "https://s3.massive.com/public/assets/news/logos/investing.png",
     "favicon_url": "https://s3.massive.com/public/assets/news/favicons/investing.ico",
     "homepage_url": "https://www.investing.com/"
    },
    "article_url": "https://uk.investing.com/news/stock-market-news/markets-are-underestimating-fed-cuts-ubs-3559968",
    "description": "UBS analysts warn that markets are underestimating the extent of future interest rate cuts by the Federal Reserve, as the weakening economy is likely to justify more cuts than currently anticipated.",
    "published_utc": "2024-06-24T18:33:53Z"
   }
  ],
  "next_url": "https://api.massive.com:443/v2/reference/news?cursor=eyJsaW1pdCI6MSwic29ydCI6InB1Ymxpc2hlZF91dGMiLCJvcmRlciI6ImFzY2VuZGluZyIsInRpY2tlciI6e30sInB1Ymxpc2hlZF91dGMiOnsiZ3RlIjoiMjAyMS0wNC0yNiJ9LCJzZWFyY2hfYWZ0ZXIiOlsxNjE5NDA0Mzk3MDAwLG51bGxdfQ",
  "request_id": "831afdb0b8078549fed053476984947a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stock-news-c6beded3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent.massive.com](https://www.zero.xyz/host/agent.massive.com/llms.txt)