yfin
a free Yahoo Finance API built for AI
Hosted at https://api.yfin.dev.
Checking API status…
Last updated: May 27, 2026.
Data
- Quotes: current quote data for one or more symbols.
- Tickers: search, autocomplete, lookup, quote type, and related symbols.
- History: candles, volume, adjusted close, corporate actions, and spark lines.
- Options: expiration dates and call/put chains.
- Fundamentals: company, ETF, and fund summary modules.
- Markets: summaries, market time, trending symbols, sectors, and industries.
- Research: insights, price insights, ratings, recommendations, and calendars.
- Screeners: securities screens and screener discovery metadata.
Routes
Public routes use /v1/{route}.
| Route | Use |
|---|---|
/v1/quote | Current quote data. |
/v1/history | Historical chart data. |
/v1/search | Finance search results. |
/v1/autocomplete | Symbol and company suggestions. |
/v1/lookup | Symbol lookup for names, indexes, funds, and ticker-like queries. |
/v1/options | Option expirations and chains. |
/v1/fundamentals | Company, ETF, and fund fundamentals. |
/v1/timeseries | Time-series fundamentals. |
/v1/spark | Lightweight recent price series. |
/v1/market_summary | Broad market snapshots. |
/v1/market_time | Market clock and session metadata. |
/v1/trending | Trending symbols by region. |
/v1/screener | Run securities screeners. |
/v1/screener_discover | Screener discovery metadata. |
/v1/calendar | Earnings, dividends, splits, IPOs, and economic events. |
/v1/insights | Research-oriented insight data. |
/v1/price_insights | Price-focused insight data. |
/v1/ratings | Analyst-rating-oriented data. |
/v1/recommendations | Related symbols. |
/v1/quote_type | Instrument classification and exchange metadata. |
/v1/sectors | Sector reference and market data. |
/v1/industries | Industry reference and market data. |
Rate limiting
Each SDK call or REST call counts as one API request.
| Tier | Limit | How to use it |
|---|---|---|
| Anonymous | 40 rps / 1,200 rpm | No setup. Limits are IP-based. |
| API key | 2,000 rps / 30,000 rpm | Verify an email, then send the returned API key. |
Contact
For higher limits or account questions, reveal the contact email.