# Yahoo Finance Scraper via x402

> Yahoo Finance Scraper via x402 is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Fetches structured stock data from Yahoo Finance including price history, financials, news, holders, and options for one or more ticker symbols, billed per call via x402.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/yahoo-finance?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yahoo-finance-scraper-via-x402-883a9005
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dJtcBARPfIWMyejqhtFkP

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 yahoo-finance-scraper-via-x402-883a9005 -d '<json body>'
```

Example prompt: Pull Yahoo Finance data for AAPL, MSFT, and NVDA from 2024-01-01 to 2024-12-31 — include financials and the last 10 news items per ticker, but skip holders and options.

## When to prefer this

Choose this endpoint when you need structured, multi-dimensional Yahoo Finance data — including price history, financials, news, holders, and options — for one or more tickers in a single pay-per-call request. It is especially useful for AI agents that need financial fundamentals alongside market data without building a Yahoo Finance scraper themselves. Prefer it over generic web scrapers when you want clean, typed JSON output and only pay on successful runs.

## Known failure modes

- Invalid or delisted ticker symbols return empty or null fields for that item
- Date range with no trading data returns empty price history array
- Network or scraping block by Yahoo Finance returns an error and no charge is applied
- Malformed date strings (not YYYY-MM-DD) may cause request rejection
- maxItems set too low may truncate results before all tickers are processed
- Options data unavailable for tickers with no listed options (e.g. ETFs without options)

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of processed tickers and an items array. Each item contains ticker symbol, company name, sector, industry, exchange, currency, quote type, and quote URL. Depending on flags, each item may also include daily price history (OHLCV), annual and quarterly income statements, balance sheets, cash flow summaries, recent news headlines with titles and timestamps, institutional/fund holder tables, and the nearest options expiration with calls and puts chains.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tickers": {
   "type": "array",
   "description": "Yahoo Finance ticker symbols. Each symbol produces one dataset item."
  },
  "end_date": {
   "type": "string",
   "description": "Last calendar date to include in daily price history (YYYY-MM-DD), inclusive. Defaults to today."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many ticker records across the run. Zero means all supplied tickers."
  },
  "start_date": {
   "type": "string",
   "description": "First calendar date to include in daily price history (YYYY-MM-DD). Defaults to one year ago."
  },
  "includeNews": {
   "type": "boolean",
   "default": true,
   "description": "Fetch recent ticker headlines from the public finance news feed."
  },
  "includeHolders": {
   "type": "boolean",
   "default": false,
   "description": "Fetch public institutional and fund holdings plus ownership summary."
  },
  "includeOptions": {
   "type": "boolean",
   "default": false,
   "description": "Fetch expiration dates and calls and puts for the nearest expiry."
  },
  "maxNewsPerTicker": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 0,
   "description": "Maximum recent news items saved for each ticker."
  },
  "includeFinancials": {
   "type": "boolean",
   "default": true,
   "description": "Fetch annual and quarterly income, balance sheet, and cash flow summaries."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "sector": null,
    "ticker": null,
    "currency": null,
    "exchange": null,
    "industry": null,
    "quoteUrl": null,
    "quoteType": null
   }
  ],
  "product": "yahoo-finance"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yahoo-finance-scraper-via-x402-883a9005/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)