# Yahoo Finance Stock & Crypto Prices Scraper (`scrapers_lat/yahoo-finance-scraper`) Actor
Extract Yahoo Finance stock and crypto market data by symbol: price, change, market cap, PE, EPS, 52-week range, volume, supply and OHLCV history. Export to JSON, CSV or Excel.
- **URL**: https://apify.com/scrapers\_lat/yahoo-finance-scraper.md
- **Developed by:** [Scrapers Lat](https://apify.com/scrapers_lat) (community)
- **Categories:** Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".
## How to integrate an Actor?
If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
[](https://console.apify.com/actors/Z3F7rwN3h9cfU6Rke/input)
## Yahoo Finance Stock & Crypto Prices Scraper
> Extract live Yahoo Finance market data for any stock, ETF, index or crypto symbol, from a single AAPL to hundreds of tickers in one run.
35 fields per record
Stocks + crypto coverage
JSON / CSV / Excel output formats
Updated 2026-07-02
### What you get
Give the scraper a list of ticker symbols and it returns one clean record per symbol with the live price, the daily move, valuation and, on request, a full OHLCV price-history series. It works for equities (AAPL, MSFT, TSLA), ETFs (SPY, QQQ), indices (^GSPC) and cryptocurrencies (BTC-USD, ETH-USD) in the same run.
- **imageUrl**: coin logo for crypto symbols
- **symbol**: the ticker as returned by the source
- **name**: full company or asset name
- **type**: equity, crypto, etf, index or currency
- **quoteType**: the source instrument type label
- **currency**: currency the price is quoted in
- **exchange**: exchange or market the symbol trades on
- **marketState**: pre, regular, post or closed
- **price**: latest regular-market price
- **change**: absolute price change on the day
- **changePercent**: percentage price change on the day
- **previousClose**: previous session close
- **open**: session opening price
- **dayHigh**: intraday high
- **dayLow**: intraday low
- **volume**: regular-market volume
- **marketCap**: market capitalization
- **fiftyTwoWeekHigh**: 52-week high
- **fiftyTwoWeekLow**: 52-week low
- **fiftyTwoWeekChangePercent**: change over the last 52 weeks
- **fiftyDayAverage**: 50-day moving average
- **twoHundredDayAverage**: 200-day moving average
- **trailingPE**: trailing price-to-earnings ratio (equities)
- **forwardPE**: forward price-to-earnings ratio (equities)
- **epsTrailingTwelveMonths**: trailing twelve-month earnings per share (equities)
- **dividendYield**: dividend yield (equities)
- **sharesOutstanding**: shares outstanding (equities)
- **bookValue**: book value per share (equities)
- **priceToBook**: price-to-book ratio (equities)
- **averageAnalystRating**: consensus analyst rating (equities)
- **postMarketPrice**: post-market price (equities)
- **postMarketChange**: post-market price change (equities)
- **postMarketChangePercent**: post-market percentage change (equities)
- **circulatingSupply**: circulating supply (crypto)
- **maxSupply**: maximum supply (crypto)
- **volume24Hr**: 24-hour trading volume (crypto)
- **marketTime**: timestamp of the quoted price
- **history**: array of OHLCV candles when a history range is selected
- **observedAt**: when this record was collected by the scraper
### Who is it for
| Use case | Who benefits |
|---|---|
| Build a live portfolio or watchlist dashboard | Retail investors and fintech builders |
| Pull daily closing prices into a spreadsheet | Analysts and accountants |
| Backtest strategies on historical OHLCV data | Quant traders and researchers |
| Track crypto price, market cap and supply | Crypto desks and treasury teams |
| Feed market data into an AI agent or model | Developers and data teams |
### Frequently Asked Questions
**Which symbols and markets does it cover?**
Any ticker that exists on Yahoo Finance: US and international stocks, ETFs, mutual funds, indices such as ^GSPC, currency pairs such as EURUSD=X, and cryptocurrencies quoted as BTC-USD or ETH-USD. Mix stocks and crypto freely in one run.
**How many symbols can I request in one run?**
Hundreds. Symbols are fetched in efficient batches, so a list of a few hundred tickers returns in a single quick run. Use Max Items to cap how many symbols are processed.
**Can I get historical prices, not just the live quote?**
Yes. Pick a History Range (for example 1mo, 1y or max) and a candle interval, and every record gets a history array of open, high, low, close, adjusted close and volume. Leave the range empty for a faster quote-only run.
**Why are some fields empty on crypto or on certain stocks?**
Fields are asset-specific. Crypto records include circulating and max supply but no price-to-earnings ratio, while equities include valuation and dividend fields but no supply. A stock that pays no dividend simply has an empty dividend yield.
**What happens if a symbol is misspelled or delisted?**
That symbol gets its own record with an error message instead of prices, and the rest of the run continues normally, so one bad ticker never breaks the batch.
### Example use cases
Ready-to-run example tasks, each preconfigured for a common scenario. Open one and press run, or use it as a template:
- [Tech Stocks AAPL MSFT NVDA Live Prices](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/tech-stocks-aapl-msft-nvda): Scrape live prices for Apple, Microsoft, Nvidia, Google and Amazon with quotes, market cap, PE ratio, day range and volume from Yahoo Finance.
- [Crypto Prices BTC ETH SOL XRP DOGE](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/crypto-prices-btc-eth-sol): Scrape live cryptocurrency prices for Bitcoin, Ethereum, Solana, XRP and Dogecoin with market cap, volume and 24h change from Yahoo Finance.
- [Dividend Stocks JNJ KO PG XOM VZ Data](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/dividend-stocks-jnj-ko-pg): Scrape dividend stock data for Johnson and Johnson, Coca-Cola, Procter and Gamble, Exxon and Verizon with yield, PE ratio and price from Yahoo Finance.
- [Stock Market Indices S&P 500 Dow Nasdaq](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/stock-market-indices-sp500-dow): Scrape live values for the S&P 500, Dow Jones, Nasdaq Composite and Russell 2000 indices with day range and change from Yahoo Finance.
- [Tesla TSLA Stock Price History 1 Year](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/tesla-stock-price-history-1y): Scrape Tesla TSLA stock quote plus one year of daily OHLCV price history with open, high, low, close and volume from Yahoo Finance.
- [EV Automaker Stocks TSLA RIVN LCID F GM](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/ev-automaker-stocks-tsla-rivn): Scrape electric vehicle and automaker stocks including Tesla, Rivian, Lucid, Ford and GM with live price, market cap and volume from Yahoo Finance.
- [Bank Stocks JPM BAC WFC GS MS Prices](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/bank-stocks-jpm-bac-wfc): Scrape bank stock prices for JPMorgan, Bank of America, Wells Fargo, Goldman Sachs and Morgan Stanley with PE ratio and yield from Yahoo Finance.
- [Semiconductor Stocks NVDA AMD INTC TSM](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/semiconductor-stocks-nvda-amd): Scrape semiconductor stocks Nvidia, AMD, Intel, TSMC and Broadcom with live price, market cap, PE ratio and volume from Yahoo Finance.
- [Forex Currency Pairs EUR GBP JPY Rates](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/forex-currency-pairs-eur-gbp-jpy): Scrape live forex exchange rates for EUR USD, GBP USD and USD JPY currency pairs with day range and change from Yahoo Finance.
- [Top ETF Prices SPY QQQ VOO VTI Data](https://apify.com/scrapers_lat/yahoo-finance-scraper/examples/top-etf-prices-spy-qqq-voo): Scrape top ETF prices for SPY, QQQ, VOO and VTI with net assets, expense data, day range and volume from Yahoo Finance.
### Export, API and AI agents (x402 + MCP)
Export the scraped data to **JSON, CSV or Excel**, pull it as a **dataset** through the Apify **API**, or wire it into your app with **no code**. This web scraper and data extractor also works for bulk data extraction and scheduled runs.
For AI agents: this Actor is available on **x402**, Apify's agentic payment standard built with Coinbase. An AI agent can discover, pay for and run it on its own with a funded wallet and a single HTTP request: no account, no subscription, no API key and no human in the loop. It also runs as an **MCP** tool inside Claude, Cursor and other AI clients out of the box. Learn more about [x402 agentic payments on Apify](https://docs.apify.com/platform/integrations/x402).
### Related scrapers
Need data from the same space? Here are other scrapers we build and maintain:
- [B3 Brazil Stock Tickers & Listed Company Scraper](https://apify.com/scrapers_lat/b3-scraper): Tickers and listed company data from Brazil's B3 exchange.
- [Argentina Dollar Blue & Oficial Exchange Rate Scraper](https://apify.com/scrapers_lat/argentina-dolar-scraper): Live blue, oficial, MEP and crypto dollar rates with history.
- [BCRA Argentina Central de Deudores Credit Risk Scraper](https://apify.com/scrapers_lat/bcra-deudores-scraper): Credit risk and debtor status from Argentina's central bank.
- [FEC Campaign Finance Scraper: Donors & Committees](https://apify.com/scrapers_lat/fec-campaign-finance-scraper): US political donors, committees and contribution records.
- [eBay Product Listings & Price Scraper](https://apify.com/scrapers_lat/ebay-scraper): Product listings, prices and seller data from eBay.
- [FMCSA Motor Carrier & USDOT Number Scraper (USA)](https://apify.com/scrapers_lat/fmcsa-carriers-scraper): US motor carrier profiles and USDOT registration data.
### More scrapers at scrapers.lat
This actor is built and maintained by [scrapers.lat](https://scrapers.lat), where we publish scrapers for Latin American and US public platforms: real estate, jobs, e-commerce, company registries and government data. Browse the full catalog, see live sample output for each one, or ask us for a custom scraper at [scrapers.lat](https://scrapers.lat).
---
> This actor is an independent tool and has no affiliation with Yahoo Finance. It only accesses data that is publicly available on the platform. Use it in accordance with Yahoo Finance's terms of service.
# Actor input Schema
## `maxItems` (type: `integer`):
Maximum number of symbols to process. Optional.
## `symbols` (type: `array`):
Ticker symbols to look up. Works for stocks and ETFs (AAPL, MSFT, TSLA, SPY), crypto (BTC-USD, ETH-USD), indices (^GSPC) and currency pairs (EURUSD=X).
## `range` (type: `string`):
Include an OHLCV price-history array for each symbol over this time range. Leave empty to fetch the live quote only (faster).
## `interval` (type: `string`):
Candle interval for the price-history array (only used when a history range is selected). Intraday intervals (1m to 1h) are only available for short ranges.
## `proxyConfiguration` (type: `object`):
Optional proxy. Yahoo Finance public endpoints work fine from a datacenter IP, so a proxy is normally unnecessary.
## Actor input object example
```json
{
"maxItems": 10,
"symbols": [
"AAPL",
"MSFT",
"BTC-USD",
"ETH-USD"
],
"range": "",
"interval": "1d",
"proxyConfiguration": {
"useApifyProxy": false
}
}
````
# Actor output Schema
## `results` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"maxItems": 10,
"symbols": [
"AAPL",
"MSFT",
"BTC-USD",
"ETH-USD"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapers_lat/yahoo-finance-scraper").call(input);
// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
console.dir(item);
});
// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs
```
## Python example
```python
from apify_client import ApifyClient
# Initialize the ApifyClient with your Apify API token
# Replace '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"maxItems": 10,
"symbols": [
"AAPL",
"MSFT",
"BTC-USD",
"ETH-USD",
],
}
# Run the Actor and wait for it to finish
run = client.actor("scrapers_lat/yahoo-finance-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"maxItems": 10,
"symbols": [
"AAPL",
"MSFT",
"BTC-USD",
"ETH-USD"
]
}' |
apify call scrapers_lat/yahoo-finance-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapers_lat/yahoo-finance-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Yahoo Finance Stock & Crypto Prices Scraper",
"description": "Extract Yahoo Finance stock and crypto market data by symbol: price, change, market cap, PE, EPS, 52-week range, volume, supply and OHLCV history. Export to JSON, CSV or Excel.",
"version": "0.1",
"x-build-id": "RR0WnCXI7QjEMKYjE"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapers_lat~yahoo-finance-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapers_lat-yahoo-finance-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/scrapers_lat~yahoo-finance-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapers_lat-yahoo-finance-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/scrapers_lat~yahoo-finance-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapers_lat-yahoo-finance-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"symbols"
],
"properties": {
"maxItems": {
"title": "Max Items",
"minimum": 1,
"maximum": 1000000,
"type": "integer",
"description": "Maximum number of symbols to process. Optional."
},
"symbols": {
"title": "Symbols",
"type": "array",
"description": "Ticker symbols to look up. Works for stocks and ETFs (AAPL, MSFT, TSLA, SPY), crypto (BTC-USD, ETH-USD), indices (^GSPC) and currency pairs (EURUSD=X).",
"items": {
"type": "string"
}
},
"range": {
"title": "History Range",
"enum": [
"",
"1d",
"5d",
"1mo",
"3mo",
"6mo",
"1y",
"2y",
"5y",
"10y",
"ytd",
"max"
],
"type": "string",
"description": "Include an OHLCV price-history array for each symbol over this time range. Leave empty to fetch the live quote only (faster).",
"default": ""
},
"interval": {
"title": "History Interval",
"enum": [
"1m",
"5m",
"15m",
"30m",
"1h",
"1d",
"1wk",
"1mo"
],
"type": "string",
"description": "Candle interval for the price-history array (only used when a history range is selected). Intraday intervals (1m to 1h) are only available for short ranges.",
"default": "1d"
},
"proxyConfiguration": {
"title": "Proxy Configuration",
"type": "object",
"description": "Optional proxy. Yahoo Finance public endpoints work fine from a datacenter IP, so a proxy is normally unnecessary.",
"default": {
"useApifyProxy": false
}
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```