Finance
Yahoo Finance logo

Yahoo Finance API

finance.yahoo.com

Yahoo Finance — real-time quotes, historical prices, analyst estimates, options chains, financials, holders, earnings, dividends, splits, trending tickers, and news.

Actions
16
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": "<ticker>"
    }
  }'

16 actions on finance.yahoo.com

Read

  • Analysis

    yf_analysisread1 credit / call

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

    ticker
    string · required
  • Currency Rates

    yf_currency_ratesread1 credit / call

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

    pairs
    array
    base
    string
  • ETF Holdings

    yf_etf_holdingsread1 credit / call

    Top 10 holdings, sector weightings, allocation breakdown, and fund profile for any ETF.

    ticker
    string · required
  • Earnings Calendar

    yf_earnings_calendarread1 credit / call

    Upcoming earnings dates and EPS/revenue estimates for a list of tickers (max 20).

    tickers
    array · required
  • Earnings History

    yf_earnings_historyread1 credit / call

    Quarterly EPS actuals vs estimates (beats/misses) and next earnings date.

    ticker
    string · required
  • Financials

    yf_financialsread1 credit / call

    Income statement history (4 periods) plus current financial snapshot — cash, debt, EBITDA, FCF, margins, and returns.

    ticker
    string · required
    period
    string
  • Holders

    yf_holdersread1 credit / call

    Institutional holders, mutual fund holders, insider ownership, and insider transactions.

    ticker
    string · required
  • Market Movers

    yf_market_moversread1 credit / call

    Top daily gainers, losers, and most active stocks by volume.

    category
    string
    count
    integer
  • News

    yf_newsread1 credit / call

    Recent news articles for a stock ticker or financial topic with publisher, link, and related tickers.

    query
    string · required
    limit
    integer
  • Options Chain

    yf_optionsread1 credit / call

    Full options chain (calls and puts) for any optionable stock or ETF with strike, bid/ask, volume, OI, and IV.

    ticker
    string · required
    expiration
    string
  • Price History

    yf_price_historyread1 credit / call

    OHLCV historical price data for any ticker, ETF, index, or crypto with configurable range and interval.

    ticker
    string · required
    range
    string
    interval
    string
  • Quote

    yf_quoteread1 credit / call

    Real-time quote with key statistics — price, market cap, P/E, beta, short interest, analyst targets, pre/post-market data.

    ticker
    string · required
  • Search

    yf_searchread1 credit / call

    Search for stocks, ETFs, indices, crypto, and funds by name or ticker.

    query
    string · required
    limit
    integer
  • Splits & Dividends

    yf_splits_dividendsread1 credit / call

    Dividend payment history, dividend yield/payout summary, and stock split history.

    ticker
    string · required
    range
    string
  • Stock Screener

    yf_screenerread1 credit / call

    Screen stocks by market cap, P/E, dividend yield, sector, price range, and more 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
  • Trending Tickers

    yf_trendingread1 credit / call

    Trending tickers on Yahoo Finance 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 16 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