Yahoo Finance Skill: Free Stock Data, Earnings, Options, and Analyst Ratings — No API Key

14,208 downloads and 36 stars. The Yahoo Finance skill — by ajanraj — provides comprehensive stock market data using the yfinance library, with zero API key or subscription required. It covers price quotes, fundamentals, earnings history, options chains, dividend data, analyst ratings, and full company profiles.

Where the related stock-market-pro skill focuses on chart generation and technical analysis, this skill is the data layer: structured financial data, formatted for agent consumption and human readability.

The Problem It Solves

Financial data APIs are expensive. Bloomberg Terminal runs $24,000/year. Refinitiv Eikon is similar. Alpha Vantage's free tier throttles at 5 requests per minute with limited historical data. Even the basic quoting APIs that were once free have either shut down, rate-limited aggressively, or moved behind paywalls.

Yahoo Finance remains one of the few sources providing comprehensive financial data at no cost. The yfinance Python library makes it accessible programmatically. This skill wraps yfinance in a clean CLI that any agent can call — covering the full breadth of data Yahoo Finance offers, not just prices.

Core Concept: uv-Powered CLI

Like stock-market-pro, this skill uses uv (PEP 723 inline script metadata) to auto-install dependencies on first run:

# First run: auto-installs yfinance + rich
yf AAPL
 
# Subsequent runs are instant (deps cached by uv)
yf AAPL

The yf script can be symlinked to your PATH for global access. Once linked, it's available as a standard CLI command from anywhere.

Deep Dive

Price (Quick Check)

yf AAPL
# equivalent
yf price AAPL

Returns current price, day change, and percentage change. The shorthand form (yf AAPL) is the fastest path to a price check.

Detailed Quote

yf quote MSFT

Expanded price data including bid/ask spread, 52-week range, volume, average volume, and day range.

Fundamentals

yf fundamentals NVDA

Outputs: P/E ratios (trailing and forward), EPS, market cap, profit margins, ROE, ROA, and analyst consensus targets. This is the data needed for valuation analysis without building a spreadsheet.

Earnings History and Estimates

yf earnings TSLA

Returns:

• Next earnings date
• EPS estimates (consensus and range)
• Earnings history with reported vs. estimated EPS and surprise percentage

Earnings surprises (beating or missing estimates) are one of the strongest short-term price drivers — having this data accessible in an agent workflow enables research questions like "what stocks have beaten earnings estimates for the last 4 consecutive quarters?"

Company Profile

yf profile GOOGL

Full business description, sector, industry, employee count, website, and headquarters address. Useful context for competitive analysis or due diligence.

Dividends

yf dividends KO

Dividend rate, yield, ex-dividend date, payout ratio, and recent dividend payment history. For income-focused investment research.

Options Chains

yf options SPY

Near-the-money calls and puts with implied volatility, open interest, and bid/ask. Available for US large-caps and ETFs.

Multi-Ticker Comparison

yf compare AAPL,MSFT,GOOGL

Side-by-side key metrics across multiple tickers — peer benchmarking without a spreadsheet.

Analyst Ratings

yf ratings AAPL

Analyst consensus (Buy/Hold/Sell), price target, and rating breakdown.

Historical OHLCV

yf history GOOGL 1mo

Supported timeframes: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max

Ticker Search

yf search "semiconductor"

Lookup tickers by company name or keyword.

Supported Markets

yf quote AAPL          # US stocks
yf quote RELIANCE.NS   # India NSE
yf quote TCS.BO        # India BSE
yf quote BTC-USD       # Crypto
yf quote EURUSD=X      # Forex
yf quote SPY           # ETFs

Supported Data Points

Comparison: Free Financial Data Options

How to Install

clawhub install yahoo-finance

Requirements:

• Python 3.11+
• uv (for dependency auto-installation)

Install uv if not present:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
 
# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Optional global access:

chmod +x /path/to/skills/yahoo-finance/yf
ln -sf /path/to/skills/yahoo-finance/yf /usr/local/bin/yf

Practical Tips

1. Combine fundamentals + earnings for investment research. Fundamentals give you the valuation picture; earnings history tells you whether the company consistently delivers on guidance. Together they answer the core investment question.
2. Use profile before analyst calls. When preparing for a company deep-dive, pull the profile first to get sector classification and employee count — these provide essential context for interpreting the financial numbers.
3. earnings surprise data is gold for agent workflows. A stock screening agent can pull earnings history for a list of tickers and filter for consistent beaters — this kind of systematic screening is exactly where the skill shines.
4. Dividend data enables income screening. yf dividends KO gives you yield and payout ratio — two of the three metrics (along with dividend growth rate, available from history) needed for dividend investing analysis.
5. Pair with stock-market-pro for complete analysis. This skill provides the data layer; stock-market-pro generates the visual chart. Use both for a complete research report.
6. Batch processing works well. Loop over a list of tickers, call yf fundamentals for each, and aggregate the results — the skill is fast enough for dozens of tickers in a single agent run.

Considerations

• Data is delayed, not real-time. Yahoo Finance data is typically delayed 15 minutes for US markets during trading hours. Not suitable for real-time trading or precise entry/exit decisions.
• yfinance reliability. Yahoo Finance has historically changed their internal API without notice, occasionally breaking yfinance. The library is actively maintained and usually updated within days, but be aware of this dependency.
• No streaming or webhooks. Each call is a snapshot. For continuous monitoring, you'd need to implement a polling loop in your agent.
• International coverage varies. US large-caps and major international indices are well-covered. Data quality for smaller international stocks, OTC markets, and some emerging market equities can be inconsistent.
• Options data. The fundamentals and quote commands don't include options chains. For options data, combine with stock-market-pro's browser-based Unusual Whales integration.
• Terms of service. Commercial use of Yahoo Finance data for products or services should be reviewed against Yahoo's terms — the data is provided for personal/research use.

The Bigger Picture

The yahoo-finance skill democratizes access to financial data that was historically expensive or technically complex to obtain. For an AI agent, having the ability to pull fundamentals, earnings history, and analyst ratings for any publicly traded company — without authentication, subscriptions, or API rate limits — fundamentally changes what financial research workflows are possible.

With 14,000+ downloads, this is clearly one of the most practically useful skills on ClawHub for anyone building finance-adjacent agents: portfolio analysis, earnings screening, competitive benchmarking, or simply answering "how does this company look fundamentally?" in a conversation.

View the skill on ClawHub: yahoo-finance