Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
A Python CLI for fetching comprehensive stock data from Yahoo Finance using yfinance.
The script requires uv - an extremely fast Python package manager. Check if it's installed:
uv --version
If not installed, install it using one of these methods:
curl -LsSf https://astral.sh/uv/install.sh | sh
brew install uv
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
pip install uv
After installation, restart your terminal or run:
source ~/.bashrc # or ~/.zshrc on macOS
The yf script uses PEP 723 inline script metadata - dependencies are auto-installed on first run.
# Make executable
chmod +x /path/to/skills/yahoo-finance/yf
# Optionally symlink to PATH for global access
ln -sf /path/to/skills/yahoo-finance/yf /usr/local/bin/yf
First run will install dependencies (yfinance, rich) to uv's cache. Subsequent runs are instant.
yf AAPL # shorthand for price
yf price AAPL
yf quote MSFT
yf fundamentals NVDA
Shows: PE ratios, EPS, market cap, margins, ROE/ROA, analyst targets.
yf earnings TSLA
Shows: Next earnings date, EPS estimates, earnings history with surprises.
yf profile GOOGL
Shows: Sector, industry, employees, website, address, business description.
yf dividends KO
Shows: Dividend rate/yield, ex-date, payout ratio, recent dividend history.
yf ratings AAPL
Shows: Buy/hold/sell distribution, mean rating, recent upgrades/downgrades.
yf options SPY
Shows: Near-the-money calls and puts with strike, bid/ask, volume, OI, IV.
yf history GOOGL 1mo # 1 month history
yf history TSLA 1y # 1 year
yf history BTC-USD 5d # 5 days
Ranges: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max
yf compare AAPL,MSFT,GOOGL
yf compare RELIANCE.NS,TCS.NS,INFY.NS
Side-by-side comparison with price, change, 52W range, market cap.
yf search "reliance industries"
yf search "bitcoin"
yf search "s&p 500 etf"
# Quick price check
yf AAPL
# Get valuation metrics
yf fundamentals NVDA
# Next earnings date + history
yf earnings TSLA
# Options chain for SPY
yf options SPY
# Compare tech giants
yf compare AAPL,MSFT,GOOGL,META,AMZN
# Find Indian stocks
yf search "infosys"
# Dividend info for Coca-Cola
yf dividends KO
# Analyst ratings for Apple
yf ratings AAPL
Install uv using the instructions above.
Yahoo Finance may rate limit excessive requests. Wait a few minutes and try again.
yf search "company name"