Finance
Yahoo Finance logo

Yahoo Finance API

finance.yahoo.com

Yahoo Finance - quotes, historical prices, options chains, financials, earnings, and news.

Actions
18
Category
Finance
Login
Not required
Output
JSON

Call the Yahoo Finance API

Submit a task, then poll the job until it settles. This example runs yf_analysis.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "yf_analysis",
    "params": {
      "ticker": "AAPL"
    }
  }'

18 actions on finance.yahoo.com

Read

  • Analyst Analysis

    yf_analysisread2 credits / call

    Returns analyst ratings, price targets, earnings and revenue estimates, and upgrade/downgrade history.

    ticker
    string · required
  • Company Financials

    yf_financialsread3 credits / call

    Returns income statement history plus a snapshot of cash, debt, EBITDA, FCF, margins, and returns.

    ticker
    string · required
    period
    string
  • Currency Rates

    yf_currency_ratesread3 credits / call

    Returns forex rates for major currency pairs with bid/ask, day range, and 52-week range.

    pairs
    array
    base
    string
  • Earnings Calendar

    yf_earnings_calendarread2 credits / call

    Returns upcoming earnings dates and EPS and revenue estimates for up to 20 tickers.

    tickers
    array · required
  • Earnings History

    yf_earnings_historyread2 credits / call

    Returns quarterly EPS actuals versus estimates and the next earnings date.

    ticker
    string · required
  • ETF Holdings

    yf_etf_holdingsread2 credits / call

    Returns top 10 holdings, sector weightings, allocation breakdown, and fund profile for an ETF.

    ticker
    string · required
  • Market Movers

    yf_market_moversread2 credits / call

    Returns the top daily gainers, losers, and most active stocks by volume.

    category
    string
    count
    integer
  • Market Sectors

    act_yahoo_finance_sectorsread1 credit / call

    Returns all market sectors with market weight, daily change, and YTD returns.

    formatted
    string
    withReturns
    string
    lang
    string
    region
    string
  • Market Summary

    act_yahoo_finance_market_summaryread1 credit / call

    Returns major market index quotes for a region with prices and change metrics.

    market
    string · required
    fields
    string
    formatted
    string
    lang
    string
    region
    string
  • Options Chain

    yf_optionsread2 credits / call

    Returns the full options chain with strike, bid/ask, volume, open interest, and implied volatility.

    ticker
    string · required
    expiration
    string
  • Price History

    yf_price_historyread2 credits / call

    Returns OHLCV historical price data for a ticker with configurable range and interval.

    ticker
    string · required
    range
    string
    interval
    string
  • Splits and Dividends

    yf_splits_dividendsread2 credits / call

    Returns dividend payment history, yield and payout summary, and stock split history.

    ticker
    string · required
    range
    string
  • Stock Holders

    yf_holdersread2 credits / call

    Returns institutional holders, mutual fund holders, insider ownership, and insider transactions.

    ticker
    string · required
  • Stock News

    yf_newsread1 credit / call

    Returns recent news articles for a ticker or topic with publisher, link, and related tickers.

    query
    string · required
    limit
    integer
  • Stock Quote

    yf_quoteread2 credits / call

    Returns a real-time quote with price, market cap, P/E, beta, short interest, and analyst targets.

    ticker
    string · required
  • Stock Screener

    yf_screenerread3 credits / call

    Returns stocks screened by market cap, P/E, dividend yield, sector, and price range with custom sorting.

    min_market_cap
    integer
    max_market_cap
    integer
    min_pe
    number
    max_pe
    number
    min_dividend
    number
    min_price
    number
    max_price
    number
    sector
    string
    sort_by
    string
    sort_order
    string
    offset
    integer
    limit
    integer
  • Ticker Search

    yf_searchread1 credit / call

    Returns stocks, ETFs, indices, crypto, and funds matching a name or ticker.

    query
    string · required
    limit
    integer
  • Trending Tickers

    yf_trendingread2 credits / call

    Returns trending tickers for a market region enriched with current price data.

    region
    string
    count
    integer

Yahoo Finance API questions

Is there an API for Yahoo Finance?
Yahoo Finance does not offer a public data API for this, but Anakin Wire provides 18 maintained endpoints for finance.yahoo.com. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape Yahoo Finance data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when finance.yahoo.com changes its markup, Anakin updates the action.
Do I need a Yahoo Finance account?
No. Every Yahoo Finance action listed here runs anonymously — no account and no credentials required.
What does the Yahoo Finance API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.

More Finance APIs

All Finance sites