Yahoo Finance Stock Quote API

This Actor retrieves a real-time stock quote from Yahoo Finance for any ticker symbol — price, day range, 52-week range, market cap, valuation ratios, analyst rating, and earnings-date info in a single call.

Note on scope: this Actor currently returns the same real-time quote data as Yahoo Finance's standard quote endpoint (price, range, volume, valuation, analyst rating, etc.). It does not return an options chain (strikes, expirations, calls/puts, open interest, implied volatility).

Features

• Ticker Information Retrieval - Obtain a comprehensive real-time quote for any ticker.
• Price Tracking - Regular market price, change, bid/ask, and intraday/52-week range.
• Valuation Metrics - Market cap, P/E (forward and trailing), EPS, book value, price-to-book.
• Moving Averages - 50-day and 200-day averages with change vs. current price.
• Analyst & Earnings - Average analyst rating and next earnings date (with estimate flag).
• Dividends - Trailing annual dividend rate and yield, where applicable.

Input

Field	Type	Description
ticker	String	Required. The stock ticker symbol to look up, e.g. TSLA, AAPL, MSFT.
lang	String	Language for the result. Default en-US.
formatted	Boolean	Whether Yahoo should return formatted (localized) number strings alongside raw values. Default false.
region	String	Region for the result. Default US.

{
  "ticker": "TSLA",
  "lang": "en-US",
  "formatted": false,
  "region": "US"
}

Output Format

Each run returns one dataset item: the full Yahoo Finance quote object for the requested ticker (around 80 fields). Key groups of fields:

• Identity — symbol, shortName, longName, displayName, quoteType, exchange, fullExchangeName, currency
• Live pricing — regularMarketPrice, regularMarketChange, regularMarketChangePercent, regularMarketDayRange, bid, ask, bidSize, askSize, marketState
• Range & averages — fiftyTwoWeekRange, fiftyDayAverage, twoHundredDayAverage
• Volume — regularMarketVolume, averageDailyVolume3Month, averageDailyVolume10Day
• Valuation — marketCap, sharesOutstanding, bookValue, priceToBook, forwardPE, trailingPE, epsForward, epsTrailingTwelveMonths
• Analyst & earnings — averageAnalystRating, earningsTimestamp, isEarningsDateEstimate
• Dividends — trailingAnnualDividendRate, trailingAnnualDividendYield
• Corporate actions — corporateActions (upcoming splits/dividends; usually an empty array)

Not every field is populated for every instrument — non-equity tickers (ETFs, indices, crypto) omit fields like epsForward or averageAnalystRating that don't apply to them.

Output Example

Trimmed to the most useful fields from a real run on TSLA (the full item returns ~80 fields):

{
  "symbol": "TSLA",
  "shortName": "Tesla, Inc.",
  "longName": "Tesla, Inc.",
  "quoteType": "EQUITY",
  "exchange": "NMS",
  "fullExchangeName": "NasdaqGS",
  "currency": "USD",
  "marketState": "REGULAR",
  "regularMarketPrice": 346.37,
  "regularMarketChange": -8.440002,
  "regularMarketChangePercent": -2.3787386,
  "regularMarketDayRange": { "low": 345.2, "high": 358.8 },
  "regularMarketVolume": 24149617,
  "bid": 346.6,
  "ask": 347.88,
  "marketCap": 1368004755456,
  "sharesOutstanding": 3949547394,
  "bookValue": 21.995,
  "priceToBook": 15.747669,
  "epsTrailingTwelveMonths": 1.06,
  "epsForward": 2.15858,
  "forwardPE": 160.46196,
  "trailingPE": 326.76416,
  "averageAnalystRating": "2.3 - Buy",
  "fiftyDayAverage": 361.4264,
  "twoHundredDayAverage": 401.41074,
  "fiftyTwoWeekRange": { "low": 297.38, "high": 498.83 },
  "averageDailyVolume3Month": 41471814,
  "trailingAnnualDividendYield": 0,
  "earningsTimestamp": "2026-07-22T20:00:00.000Z",
  "isEarningsDateEstimate": true
}

How to Use

1. Provide the ticker symbol as input (see Input above).
2. Run the Actor — it returns one dataset item containing the full quote.
3. Pull the fields you need from the Output Format list above, or grab everything.

Use Cases

• Building a lightweight stock-price dashboard or watchlist
• Feeding a portfolio tracker with live price and valuation data
• Screening tickers by valuation ratios (P/E, price-to-book) or analyst rating
• Monitoring upcoming earnings dates across a list of symbols