yahoofinance.com APIyahoofinance.com ↗
Access real-time stock quotes, OHLCV history, company profiles, and financial news for any ticker via the Yahoo Finance API. 5 endpoints, global exchange coverage.
curl -X GET 'https://api.parse.bot/scraper/4bf1943d-6bf2-4dcc-bc83-994300c2633d/get_quote?symbols=AAPL%2CMSFT' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve real-time stock quotes including current price, bid/ask, volume, market cap, and market status for one or more tickers.
| Param | Type | Description |
|---|---|---|
| symbolsrequired | string | Comma-separated list of stock ticker symbols (e.g., AAPL,MSFT,TSLA). |
{
"type": "object",
"fields": {
"quotes": "array of objects containing real-time market data including regularMarketPrice, regularMarketChange, regularMarketVolume, marketCap, bid, ask, and symbol"
},
"sample": {
"data": {
"quotes": [
{
"ask": 299.98,
"bid": 291.2,
"symbol": "AAPL",
"currency": "USD",
"marketCap": 4389609930752,
"shortName": "Apple Inc.",
"regularMarketPrice": 298.87,
"regularMarketChange": 4.07,
"regularMarketVolume": 45300552
}
]
},
"status": "success"
}
}About the yahoofinance.com API
The Yahoo Finance API exposes 5 endpoints covering real-time quotes, historical OHLCV data, company fundamentals, financial news, and ticker search across global exchanges. The get_quote endpoint returns live market data including regularMarketPrice, regularMarketVolume, and marketCap for one or more comma-separated symbols in a single call. Historical data goes back to max range at intervals as granular as 1 minute.
Real-Time and Historical Market Data
The get_quote endpoint accepts a comma-separated symbols parameter and returns an array of quote objects. Each object includes current price fields (regularMarketPrice, regularMarketChange), volume, market cap, and market status — useful for monitoring multiple tickers in one request. The get_historical_data endpoint takes a single symbol along with optional range and interval parameters. Supported ranges span 1d through max, and intervals run from 1m up to 3mo, giving fine-grained control over the time series returned. Each history record includes timestamp, open, high, low, close, and volume, plus a currency field on the response object.
Company Profiles and Fundamentals
The get_company_profile endpoint returns four structured sub-objects for a given ticker. assetProfile covers address, sector, industry, business summary, and company officers. financialData includes currentPrice, totalRevenue, profitMargins, and analyst recommendationKey. summaryDetail adds dividend data, trailing P/E, 52-week range, and market cap. defaultKeyStatistics surfaces enterpriseValue, forwardPE, pegRatio, sharesOutstanding, and bookValue.
News and Ticker Search
get_stock_news returns an array of news articles tied to a symbol. Each article object contains uuid, title, publisher, link, providerPublishTime, and relatedTickers. An optional count parameter controls how many articles are returned. The search_tickers endpoint accepts a free-text query — a company name, partial name, or ticker string — and returns matching instruments including equities, ETFs, and other asset types. Each result carries symbol, shortname, longname, exchange, quoteType, sector, and industry.
- Building a stock screener using
regularMarketPrice,marketCap, and volume fromget_quote - Backtesting trading strategies with OHLCV data from
get_historical_dataat 1-minute to daily intervals - Populating company profile pages with sector, industry, and business summaries from
get_company_profile - Displaying analyst recommendations and profit margins via
financialDatafields in investor dashboards - Aggregating financial news feeds per ticker using
get_stock_newswith related tickers for cross-linking - Resolving user-typed company names to canonical ticker symbols via
search_tickers - Tracking dividend yield and 52-week range changes using
summaryDetailfields fromget_company_profile
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Yahoo Finance have an official developer API?+
What does `get_historical_data` return and how granular can the interval be?+
symbol. Each record contains timestamp, open, high, low, close, and volume. The interval parameter accepts values from 1m (one minute) up to 3mo, and the range parameter can extend back as far as max for the full available history. Note that very short intervals (e.g. 1m) are only available for recent ranges — the API will not return per-minute data for multi-year lookups.Does the API return options chain or futures data?+
Can I retrieve financial statements such as income statements or balance sheets?+
get_company_profile endpoint returns financial ratios and key statistics like totalRevenue, profitMargins, and enterpriseValue, but full structured financial statements (income statement line items, balance sheet, cash flow) are not included. You can fork this API on Parse and revise it to add a financial statements endpoint.How fresh is the data returned by `get_quote`?+
get_quote reflect the market status of each symbol — the response includes a market status indicator so you can tell whether the price is from an active session, pre-market, or after-hours. During active market hours, quotes reflect near-real-time data consistent with what Yahoo Finance displays on its site. There is no intraday tick-by-tick stream; this is a polling endpoint.