# Yahoo Finance API

> The Yahoo Finance API by everydata.io returns live Yahoo Finance data (quotes, fundamentals, charts, options, analysis) as structured JSON: 41 endpoints under /yho, one API key, 100 free requests a month.

- URL: https://everydata.io/apis/yahoo-finance
- Updated: 2026-10-05
- Publisher: everydata.io (https://everydata.io)

The everydata.io Yahoo Finance API returns Yahoo Finance market data as JSON: symbol autocomplete, company profiles, statistics, fundamentals, historical prices with dividends, charts, holders, insider transactions, options chains and analyst insights – one API key, no scraping on your side.

40+ endpoints for market data: symbol autocomplete, profiles, statistics, fundamentals, historical prices, charts, holders, insider activity, options and analyst insights.

## Key facts

- Status: live
- Endpoints: 41 (path prefix `/yho`)
- Quota: A call to the Yahoo Finance API counts as 1 request against the monthly quota.
- Pricing: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). One quota is shared across all 34 platforms; failed requests (5xx, blocked pages) are not counted.
- Measured average response time (last 24 h): 1.2 s, success rate 100% – live figures at https://everydata.io/status
- Authentication: `x-api-key` header

## Endpoints

- `GET /yho/auto-complete` – Auto Complete. Yahoo Finance Stock: Auto Complete. Params: `q`, `region`?.
- `GET /yho/stock-v3-get-profile` – Profile V3. Yahoo Finance Stock: Profile V3. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-v4-get-statistics` – Statistics V4. Yahoo Finance Stock: Statistics V4. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-fundamentals` – Fundamentals. Yahoo Finance Stock: Fundamentals. Params: `symbol`, `region`?, `lang`?, `modules`?.
- `GET /yho/stock-v2-get-timeseries` – Timeseries V2. Yahoo Finance Stock: Timeseries V2. Params: `symbol`, `period1`, `period2`, `region`?, `type`?.
- `GET /yho/stock-v3-get-historical-data` – Historical Data V3. Yahoo Finance Stock: Historical Data V3. Params: `symbol`, `region`?, `range`?, `interval`?, `comparisons`?, `period1`?, `period2`?.
- `GET /yho/stock-v3-get-chart` – Chart V3. Yahoo Finance Stock: Chart V3. Params: `symbol`, `range`, `interval`, `region`?, `events`?, `includePrePost`?, `useYfid`?, `includeAdjustedClose`?, `comparisons`?, `period1`?, `period2`?.
- `GET /yho/stock-v3-get-holders` – Holders V3. Yahoo Finance Stock: Holders V3. Params: `symbol`, `region`?, `lang`?, `straddle`?.
- `GET /yho/stock-v2-get-insider-transactions` – Insider Transactions V2. Yahoo Finance Stock: Insider Transactions V2. Params: `symbol`, `region`?.
- `GET /yho/stock-v2-get-insider-roster` – Insider Roster V2. Yahoo Finance Stock: Insider Roster V2. Params: `symbol`, `region`?.
- `GET /yho/stock-get-top-holdings` – Top Holdings. Yahoo Finance Stock: Top Holdings. Params: `symbol`, `region`?, `lang`?, `straddle`?.
- `GET /yho/stock-v2-get-analysis` – Analysis V2. Yahoo Finance Stock: Analysis V2. Params: `symbol`, `region`?.
- `GET /yho/stock-get-recommendation-trend` – Recommendation Trend. Yahoo Finance Stock: Recommendation Trend. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-v2-get-recommendations` – Recommendations V2. Yahoo Finance Stock: Recommendations V2. Params: `symbol`.
- `GET /yho/stock-v3-get-upgrades-downgrades` – Upgrades/Downgrades V3. Yahoo Finance Stock: Upgrades/Downgrades V3. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-what-analysts-are-saying` – Analysts Reports. Yahoo Finance Stock: Analysts Reports. Params: `symbols`, `region`?, `lang`?.
- `GET /yho/stock-get-earnings` – Stock Earnings. Yahoo Finance Stock: Stock Earnings. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-sec-filings` – Sec Fillings. Yahoo Finance Stock: Sec Fillings. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-fees-and-expenses` – Fees and Expenses. Yahoo Finance Stock: Fees and Expenses. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-futures-chain` – Futures Chain. Yahoo Finance Stock: Futures Chain. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-v3-get-options` – Options V3. Yahoo Finance Stock: Options V3. Params: `symbol`, `region`?, `lang`?, `straddle`?.
- `GET /yho/stock-v3-get-insights` – Insights V3. Yahoo Finance Stock: Insights V3. Params: `symbol`.
- `GET /yho/stock-get-recent-updates` – Recent Updates. Yahoo Finance Stock: Recent Updates. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-company-outlook` – Company Outlook. Yahoo Finance Stock: Company Outlook. Params: `symbol`, `region`?, `lang`?.
- `GET /yho/stock-get-events-calendar` – Events Calendar. Yahoo Finance Stock: Events Calendar. Params: `modules`, `tickersFilter`, `startDate`?, `endDate`?, `countPerDay`?, `secFilingsTypeFilter`?, `region`?, `lang`?.
- `GET /yho/market-v2-get-quotes` – Quotes V2. Yahoo Finance Market: Quotes V2. Params: `symbols`, `region`.
- `GET /yho/market-v2-get-summary` – Market Summary V2. Yahoo Finance Market: Market Summary V2. Params: `region`.
- `GET /yho/market-v2-get-movers` – Movers V2. Yahoo Finance Market: Movers V2. Params: `region`?, `lang`?, `start`?, `number`?.
- `GET /yho/market-get-trending-tickers` – Trending Tickers. Yahoo Finance Market: Trending Tickers. Params: `region`?.
- `GET /yho/market-get-spark` – Market Spark. Yahoo Finance Market: Market Spark. Params: `symbols`, `interval`?, `range`?.
- `GET /yho/market-get-earnings` – Market Earnings. Yahoo Finance Market: Market Earnings. Params: `region`, `startDate`, `endDate`, `size`?.
- `GET /yho/market-get-tickers-by-quote-type` – Tickers by Quote Type. Yahoo Finance Market: Tickers by Quote Type. Params: `region`?, `lang`?, `quoteType`?, `query`?.
- `GET /yho/market-get-popular-watchlists` – Popular Watchlists. Yahoo Finance Market: Popular Watchlists.
- `GET /yho/screeners-get-filters` – Screeners Filters. Yahoo Finance Market: Screeners Filters. Params: `quoteType`?, `category`?, `region`?.
- `POST /yho/screeners-list` – Screeners List. Yahoo Finance Market: Screeners List. Params: `quoteType`?, `sortField`?, `sortType`?, `region`?, `offset`?, `size`?.
- `GET /yho/screeners-list-by-ticker` – Screeners List by Ticker. Yahoo Finance Market: Screeners List by Ticker. Params: `ticker`.
- `GET /yho/screeners-get-symbols-by-predefined` – Screeners Symbols by predefined. Yahoo Finance Market: Screeners Symbols by predefined. Params: `scrIds`, `count`?, `start`?.
- `POST /yho/calendar-get-events` – Calendar Events. Yahoo Finance Market: Calendar Events. Params: `entityIdType`, `size`?, `offset`?, `sortField`?, `includeFields`?, `lang`?.
- `POST /yho/calendar-count-events` – Count Events. Yahoo Finance Market: Count Events. Params: `entityIdType`, `region`?, `lang`?.
- `POST /yho/news-v2-list` – News V2. Yahoo Finance News: News V2. Params: `s`?, `region`?, `snippetCount`?.
- `GET /yho/news-v2-get-details` – News Details V2. Yahoo Finance News: News Details V2. Params: `uuid`, `region`?.

## Example

```bash
curl -s "https://api.everydata.io/yho/stock-v3-get-profile?symbol=AAPL&region=US" \
  -H "x-api-key: YOUR_API_KEY"
```

```json
{
  "quoteSummary": {
    "result": [
      {
        "assetProfile": {
          "longName": "Apple Inc.",
          "sector": "Technology",
          "industry": "Consumer Electronics",
          "fullTimeEmployees": 164000,
          "website": "https://www.apple.com"
        }
      }
    ]
  }
}
```

## Use cases

- Portfolio tools
- Quant research
- Financial dashboards
- Screeners

## FAQ

### Is there an official Yahoo Finance API?

No. Yahoo shut down its public finance API in 2017 and has not offered a replacement with keys or documented endpoints. everydata.io is an independent service, not affiliated with Yahoo: it reads the public Yahoo Finance data when you call it and returns it as JSON, with only an everydata.io API key.

### What data does the Yahoo Finance API return?

Quotes, fundamentals, charts, options, analysis. The API has 41 endpoints under the /yho path – auto complete, profile, statistics, fundamentals, historical data, chart, holders, insider transactions, analysis, options and insights – and every response is structured JSON that starts with responseStatus and responseMessage.

### How much does the Yahoo Finance API cost?

A call to the Yahoo Finance API counts as 1 request against the monthly quota. The Yahoo Finance API is included in every plan and shares one quota with all other platforms: 100 free requests a month; paid plans from €30 a month for 5,000 requests (€1.00–€6.00 per 1,000 requests). Failed requests (5xx, blocked pages) are not counted.

### Is the Yahoo Finance data realtime?

Yes. Each request loads the live Yahoo Finance page when you call the API – there is no database of old snapshots in between.

### Do I need a Yahoo Finance account or an official Yahoo Finance API key?

No. You only need an everydata.io API key, sent in the x-api-key header. The free plan works without a credit card.

### Is this a Yahoo Finance scraper?

It replaces one. everydata.io loads the live Yahoo Finance pages for you and returns parsed JSON fields, so you do not build or maintain a Yahoo Finance scraper, parser or proxy setup yourself. Retries are included, and a request that still fails costs no quota.

### What happens when Yahoo Finance blocks a request?

The API retries the fetch automatically. If the page still cannot be loaded you get a 502 or 503 error, and that request costs no quota. Success rates and response times per platform are measured around the clock on the status page.

### Can ChatGPT, Claude or an AI agent use the Yahoo Finance API?

Yes. Connect the hosted everydata.io MCP server and the assistant can call every Yahoo Finance endpoint as a tool, or register the plain HTTPS endpoints as functions in any agent framework. The endpoint list is also in /llms.txt and the OpenAPI spec.

## More

- [All platforms](https://everydata.io/apis) · [Pricing](https://everydata.io/pricing) · [API reference](https://everydata.io/docs) · [Getting started](https://everydata.io/docs/getting-started) · [MCP server](https://everydata.io/docs/mcp) · [Status](https://everydata.io/status)
- Machine-readable: [llms.txt](https://everydata.io/llms.txt), [llms-full.txt](https://everydata.io/llms-full.txt), [OpenAPI](https://api.everydata.io/openapi.json)
