# Yahoo Finance API for Historical Data

> Yahoo Finance historical data as JSON: OHLCV with Adj Close, dividends and splits back to the first trade, plus fundamentals. 100 free calls a month.

- URL: https://everydata.io/yahoo-finance-stock-data-api
- Updated: 2026-09-30
- Publisher: everydata.io (https://everydata.io)

Yahoo Finance quietly carries everything a research tool needs: adjusted price history back to the first trading day, a statistics tab with trailing and forward multiples, a company profile and quarterly financial statements. The everydata.io Yahoo Finance API exposes those views, including the full price history, as HTTPS endpoints under /yho that return the JSON Yahoo itself renders – unmodified quoteSummary.result[] objects with {raw, fmt} value pairs – so what you know about Yahoo's data model carries over one to one. Yahoo has not offered an official public Finance API since 2017; this is a maintained, hosted way to get the same numbers with an API key instead of a scraper you babysit.

## Key facts

- Platform: [Yahoo Finance API](https://everydata.io/apis/yahoo-finance) (live)
- Main endpoint: `GET /yho/stock-v3-get-historical-data`
- 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.

## What you get

The historical-data endpoint gives you a flat prices[] array of {date, open, high, low, close, volume, adjclose} where date is a Unix timestamp in seconds. Choose a range from 1d up to max (1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max) and an interval from 1m up to 3mo (1m, 2m, 5m, 15m, 30m, 60m, 1d, 1wk, 1mo), or replace range with explicit period1/period2 epoch bounds when you backfill a specific window. Intraday intervals only cover the recent past, exactly as on Yahoo's chart.

Around the price series sit the descriptive endpoints. /stock-v4-get-statistics returns summaryDetail (marketCap, trailingPE, forwardPE, dividendYield, beta) and defaultKeyStatistics (enterpriseValue, profitMargins, floatShares, sharesShort, heldPercentInstitutions). /stock-v3-get-profile delivers sector, industry, website and fullTimeEmployees. /stock-get-fundamentals takes a comma-separated modules parameter – balanceSheetHistory, cashflowStatementHistoryQuarterly, incomeStatementHistory, earningsTrend and around 30 more – and returns only those modules.

- prices[] with date (epoch seconds), open, high, low, close, volume and adjclose; eventsData for dividends and splits
- range 1d…max and interval 1m…3mo, or absolute period1/period2 bounds for precise backfills
- Key statistics with numeric raw values and Yahoo's display strings ({raw: 38.59, fmt: "38.59"})
- Company profile: sector, industry, website, employee count, address, officer list
- Fundamentals by module: annual and quarterly balance sheet, cash flow, income statement, earnings history and trend
- Symbol lookup via /auto-complete – free text in, exchange-qualified symbol out
- Twelve regions: US, BR, AU, CA, FR, DE, HK, IN, IT, ES, GB, SG with matching lang codes

## How it works

Start with the symbol as Yahoo writes it – AAPL, SAP.DE, 0700.HK. If you only have a company name, call GET /yho/auto-complete?q=apple first; quotes[] returns symbol, exchange and quoteType so you can pick the equity rather than a future or ETF.

```bash
curl -s "https://api.everydata.io/yho/stock-v3-get-historical-data?symbol=AAPL&region=US&range=1mo&interval=1d" \
  -H "x-api-key: YOUR_API_KEY"
```

Response (shortened):

```json
{
  "prices": [
    {
      "date": 1789738200,
      "open": 337.9100036621094,
      "high": 338.489990234375,
      "low": 332.5299987792969,
      "close": 336.1300048828125,
      "volume": 86433100,
      "adjclose": 336.1300048828125
    },
    {
      "date": 1789651800,
      "open": 334.7699890136719,
      "high": 338.3399963378906,
      "low": 330.17999267578125,
      "close": 337,
      "volume": 36700200,
      "adjclose": 337
    }
  ],
  "isPending": false,
  "firstTradeDate": 345479400,
  "id": "AAPL",
  "timeZone": {
    "gmtOffset": -14400
  },
  "eventsData": [
    {
      "amount": 0.27,
      "date": 1786368600,
      "type": "DIVIDEND"
    },
    {
      "amount": 0.27,
      "date": 1778506200,
      "type": "DIVIDEND"
    }
  ]
}
```

eventsData lists the corporate actions inside the requested range: every cash dividend as {amount, date, type: "DIVIDEND"} in the listing currency per share, and splits as type "SPLIT" with splitRatio. In the sample above Apple paid $0.27 per share twice within six months. Sum the amounts per calendar year for a dividend history, or join them to prices[] by date to build a total-return series yourself.

prices[] is ordered newest first, mirroring Yahoo's historical-data table. adjclose already reflects splits and dividends, so use it for return calculations and close for anything that must match the printed closing price. timeZone.gmtOffset tells you the exchange offset in seconds – -14400 is US Eastern daylight time – which you need to turn the epoch dates back into trading days for non-US listings.

Statistics and fundamentals come back in Yahoo's quoteSummary envelope: quoteSummary.result[0].summaryDetail.trailingPE is {raw: 38.591274, fmt: "38.59"}. Read raw for maths and fmt for display. Empty objects such as "yield": {} mean Yahoo has no value for that field on this instrument type.

region selects the Yahoo edition, which matters for localised display strings (typeDisp "Aktie" under region=DE) and for how a bare symbol resolves. Every call is realtime; there is no cached snapshot in between.

## What teams build with this

### Backtesting and quant research

Download 10y or max daily history for a universe of symbols, store adjclose, and run factor or momentum studies. Use 1wk or 1mo intervals when you only need coarse bars and want smaller payloads.

### Portfolio and net-worth trackers

Resolve user input through auto-complete, then refresh positions with 1d history and summaryDetail. The regularMarketPreviousClose and dividendRate fields feed daily P&L and income projections.

### Fundamental screeners

Combine defaultKeyStatistics (profitMargins, enterpriseValue, heldPercentInstitutions) with incomeStatementHistory from the fundamentals endpoint to rank companies on margins, growth or leverage.

### Research dashboards

Show a company card with profile, employee count and years of quarterly statements without maintaining your own filings parser.

## Pricing

One request equals one endpoint call regardless of range – a max-range daily history for one symbol costs the same as a 1d call. The free plan (100 requests a month) covers a course project or prototype; Starter (5,000 requests, €30) refreshes a 150-symbol watch list daily with room for statistics; Production (50,000, €80) handles nightly fundamentals pulls across a few thousand tickers. Yahoo-side 5xx responses are never billed.

## FAQ

### Is there an official Yahoo Finance API?

Not any more. Yahoo retired its public Finance API in 2017, and the YQL service behind many old tutorials went with it. What remains are the JSON endpoints Yahoo's own website uses; libraries such as yfinance or yahoo-finance2 call those unofficially. everydata.io serves the same data as a documented REST API with a key, fixed parameters and status monitoring.

### How do I get Adj Close and dividends in the historical data?

Call /yho/stock-v3-get-historical-data with symbol, range and interval. Every row in prices[] carries both close and adjclose, and eventsData lists the dividends ({amount, date, type: "DIVIDEND"}) and splits in the same range – no second request needed.

### How is this different from yfinance or yahoo-finance2?

Those open-source libraries fetch Yahoo's pages from your own machine, so cookies, consent pages, rate limits and changes on Yahoo's side are your problem. Here the request runs on our side, the response shape stays stable, and failed upstream calls (5xx) are not billed. The field names match Yahoo's JSON, so porting code is mostly a URL change.

### How far back does the price history go?

As far as Yahoo has data – range=max returns everything from firstTradeDate onwards, which is 1980 for AAPL. Daily, weekly and monthly bars cover the full history; intraday intervals (1m to 60m) are limited to the recent window Yahoo shows on its chart.

### Which symbol format do I use for non-US stocks?

Yahoo's suffix notation: SAP.DE for Xetra, VOD.L for London, 0700.HK for Hong Kong, RELIANCE.NS for the NSE. When unsure, call /yho/auto-complete with the company name and read the symbol and exchDisp fields from quotes[].

### Are the responses the same shape as Yahoo's own JSON?

Yes. Statistics, profile and fundamentals arrive as quoteSummary.result[] with {raw, fmt, longFmt} values; historical data is a prices[] array. Existing code written against Yahoo's structures works without remapping.

### What is the difference between close and adjclose?

close is the price printed at the end of the session. adjclose is back-adjusted for splits and cash dividends so that historical returns are comparable. Use adjclose for performance maths and close when matching statements or charts.

### Is this realtime exchange data?

It is the data Yahoo Finance displays publicly, at the moment you call. Delays follow the exchange rules Yahoo applies – many US quotes are realtime, others are delayed 15 to 20 minutes. It is meant for research, dashboards and analytics, not as a licensed feed for order routing.

## Related use cases

- [Yahoo Finance Options Chain & Market Data API](https://everydata.io/yahoo-finance-market-data-api)
- [Zillow API for Property Data](https://everydata.io/zillow-property-data-api)
- [Amazon Product API](https://everydata.io/amazon-product-data-api)

## 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)
