Yahoo Finance Market Data API

Fetch comprehensive Yahoo Finance market data for stocks, ETFs, indices, crypto, and FX tickers. Built as a fast Apify Actor with structured JSON output and per-module controls.

Why this Actor

• Cheaper than the leading Yahoo Finance Actor: $0.75 / 1,000 ticker records instead of $0.90 / 1,000.
• More control: choose period, interval, enabled modules, max news, max options expirations, and max rows per table.
• Batch-ready: fetch many symbols in one run.
• Failure-tolerant: if one module fails for a ticker, the Actor still returns the rest of the data plus an errors array.
• Analysis-ready JSON: output works well for APIs, spreadsheets, databases, dashboards, and AI agents.

Input example

{
  "tickers": ["AAPL", "MSFT", "TSLA"],
  "period": "1y",
  "interval": "1d",
  "includeHistory": true,
  "includeFinancials": true,
  "includeNews": true,
  "includeOptions": true,
  "maxOptionExpirations": 1,
  "maxNews": 10,
  "maxRowsPerTable": 500
}

You can also use custom historical date ranges:

{
  "tickers": ["AAPL", "BTC-USD", "^GSPC"],
  "start_date": "2025-01-01",
  "end_date": "2025-06-30",
  "interval": "1d"
}

Input fields

• tickers — required list of Yahoo Finance symbols, e.g. AAPL, MSFT, BTC-USD, EURUSD=X, ^GSPC.
• period — historical range when start_date is empty: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max.
• interval — candle interval: 1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo, 3mo.
• start_date, end_date — optional custom date range in YYYY-MM-DD format.
• includeHistory — OHLCV price history.
• includeFinancials — income statement, balance sheet, cash flow.
• includeDividends — dividend history.
• includeSplits — stock split history.
• includeNews + maxNews — latest Yahoo Finance news.
• includeRecommendations — analyst recommendations and upgrades/downgrades.
• includeHolders — major, institutional, and mutual fund holders.
• includeOptions + maxOptionExpirations — options expiration list and chains.
• includeEarnings — earnings dates and earnings-related tables.
• maxRowsPerTable — safety limit for nested tables; set to 0 for no limit.

Output

Each dataset item is one ticker record:

{
  "ticker": "AAPL",
  "fetched_at": "2026-07-06T18:30:00Z",
  "stock_info": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "quote_type": "EQUITY",
    "exchange": "NMS",
    "currency": "USD",
    "sector": "Technology",
    "industry": "Consumer Electronics",
    "market_cap": 2922039738368,
    "current_price": 195.64,
    "previous_close": 198.42,
    "day_high": 198.7,
    "day_low": 195.2,
    "pe_ratio": 30.1,
    "dividend_yield": 0.005,
    "beta": 1.2
  },
  "price_info": {
    "symbol": "AAPL",
    "current_price": 195.64,
    "previous_close": 198.42,
    "change": -2.78,
    "change_percent": -1.40,
    "timestamp": "2026-07-06T18:30:00Z"
  },
  "history": {
    "symbol": "AAPL",
    "period": "1y",
    "interval": "1d",
    "data": [
      {"Date": "2025-07-07T04:00:00Z", "Open": 210.0, "High": 212.0, "Low": 208.0, "Close": 211.0, "Volume": 12345678}
    ]
  },
  "financials": {
    "symbol": "AAPL",
    "income_statement": [],
    "balance_sheet": [],
    "cash_flow": []
  },
  "dividends": {"symbol": "AAPL", "dividends": []},
  "splits": {"symbol": "AAPL", "splits": []},
  "news": {"symbol": "AAPL", "news": []},
  "recommendations": {"symbol": "AAPL", "recommendations": [], "upgrades_downgrades": []},
  "holders": {"symbol": "AAPL", "major_holders": [], "institutional_holders": [], "mutualfund_holders": []},
  "options": {"symbol": "AAPL", "available_expirations": [], "chains": []},
  "earnings": {"symbol": "AAPL", "earnings_dates": []},
  "errors": []
}

Notes

Yahoo Finance availability varies by symbol and asset type. Some modules are not available for indices, crypto, currencies, or thinly traded instruments. When a module is unavailable, the Actor returns an empty array and/or a clear entry in errors instead of failing the whole run.