Agent skill · data analytics · sundial-org

yahoo-finance

Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.

Why this skill is useful

Provides specific commands and usage patterns for fetching stock data from Yahoo Finance that the AI wouldn't reliably generate on its own.

What it needs

Requires uv installed locally. About 2k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.

What this skill does

Yahoo Finance CLI A Python CLI for fetching comprehensive stock data from Yahoo Finance using yfinance. Requirements Python 3.11+ uv (for inline script dependencies) Installing uv The script requires uv - an extremely fast Python package manager. Check if it's installed: If not installed, install it using one of these methods: macOS / Linux macOS (Homebrew) Windows pip (any platform) After installation, restart your terminal or run: Installation The yf script uses PEP 723 inline script metadata - dependencies are auto-installed on first run. First run will install dependencies (yfinance, rich) to uv's cache. Subsequent runs are instant. Commands Price (quick check) Quote (detailed) Fundamentals Shows: PE ratios, EPS, market cap, margins, ROE/ROA, analyst targets. Earnings Shows: Next earnings date, EPS estimates, earnings history with surprises. Company Profile Shows: Sector, industry, employees, website, address, business description. Dividends Shows: Dividend rate/yield, ex-date, payout ratio, recent dividend history. Analyst Ratings Shows: Buy/hold/sell distribution, mean rating, recent upgrades/downgrades. Options Chain Shows: Near-the-money calls and puts with strike, bid/ask, volume, OI, IV. History Ranges: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max Compare Side-by-side comparison with price, change, 52W range, market cap. Search Symbol Format US stocks: AAPL, MSFT, GOOGL, TSLA Indian NSE: RELIANCE.NS, TCS.NS, INFY.NS Indian BSE: RELIANCE.BO, TCS.BO Crypto: BTC-USD, ETH-USD Forex: EURUSD=X, GBPUSD=X ETFs: SPY, QQQ, VOO Examples Troubleshooting "command not found: uv" Install uv using the instructions above. Rate limiting / connection errors Yahoo Finance may rate limit excessive requests. Wait a few minutes and try again. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills sundial-org/yahoo-finance

View the source on GitHub

Browse the @skills marketplace