# Heurist Mesh: Yahoo Finance News Search

> Heurist Mesh: Yahoo Finance News Search is a paid API for AI agents from mesh.heurist.xyz, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns news headlines and source URLs for a stock symbol, company, asset, or market topic using Yahoo Finance, with fallback to Exa digest summaries for complex topical queries.

## Facts

- Endpoint: POST https://mesh.heurist.xyz/x402/solana/agents/YahooFinanceAgent/news_search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heurist-mesh-yahoo-finance-news-search-51b1ee9a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ibEgRD9UXmQXKYMtYHbgG

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 heurist-mesh-yahoo-finance-news-search-51b1ee9a -d '<json body>'
```

Example prompt: Can you pull the latest news headlines for NVDA from Yahoo Finance so I can see what's driving the stock today?

## When to prefer this

Use this endpoint when you need quick, current news headlines tied to a specific stock symbol, company name, or cryptocurrency ticker via Yahoo Finance. It is ideal for single-symbol lookups or short queries. For longer topical market questions it gracefully falls back to an Exa digest summary. Prefer this over general web search when the user's intent is financial news tied to a specific asset, and over the market-wide news summary endpoint when you need news scoped to a particular symbol rather than macro-level coverage.

## Known failure modes

- Unknown or invalid ticker symbol returns empty results or an error
- Highly niche or obscure assets may return no Yahoo Finance coverage
- 3+ word topical queries may trigger Exa fallback, returning a summary instead of individual headlines
- Network or upstream Yahoo Finance availability issues may cause timeouts
- Overly broad market queries may return irrelevant or mixed results

## How this service works

Return news headlines and source URLs for a symbol, company, asset, or market topic. For 3+ word topical queries, this may redirect to an Exa digest fallback and return a summarized search result instead of Yahoo headline rows.

## Output

Returns a list of news headlines with their corresponding source URLs for the queried symbol or company. For queries of 3 or more words on a topical theme, the endpoint may redirect to an Exa digest fallback and return a summarized search result rather than individual Yahoo Finance headline rows.

## 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": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "debug": {
       "type": "boolean",
       "default": false,
       "description": "Debug mode flag. ALWAYS use false."
      },
      "limit": {
       "type": "integer",
       "default": 5,
       "description": "Maximum number of news items to return."
      },
      "query": {
       "type": "string",
       "description": "1-2 word search term: a ticker, company name, or short topic phrase (e.g. 'AAPL', 'Nvidia', 'tariffs impact'). Do not use sentences or questions."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "result": {
       "type": "object",
       "additionalProperties": true
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heurist-mesh-yahoo-finance-news-search-51b1ee9a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mesh.heurist.xyz](https://www.zero.xyz/host/mesh.heurist.xyz/llms.txt)