{"uid":"cap_dJtcBARPfIWMyejqhtFkP","slug":"yahoo-finance-scraper-via-x402-883a9005","name":"Yahoo Finance Scraper via x402","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/yahoo-finance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_T3y1bUCHvsChLPjzDSdGy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Portfolio earnings research dashboard","prompt":"Fetch Yahoo Finance data for TSLA, AMZN, and GOOGL covering the last two years — include annual and quarterly financials, up to 20 recent news items per ticker, and skip holders and options. I want to compare their revenue trends."},{"title":"Options expiry scouting for a single ticker","prompt":"Get me the nearest options expiry dates, calls, and puts for SPY from Yahoo Finance — I don't need news or financials, just the options data for today."},{"title":"Institutional ownership snapshot","prompt":"Pull institutional and fund holder data for MSFT and AAPL from Yahoo Finance — include the ownership summary but skip news, financials, and options. Just give me who's holding what."}],"resultDescription":"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.","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:16.668Z","isFirstParty":false,"canonicalSlug":"yahoo-finance-scraper-via-x402-883a9005"}