yfinance

Fetch Yahoo Finance market data, fundamentals, and analyst intelligence via Python.

4|Updated May 5, 2026
One-click install
npx skills add https://github.com/mthli/skills --skill yfinance-mthli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: yfinance
Source: https://github.com/mthli/skills/tree/main/yfinance
Command: npx skills add https://github.com/mthli/skills --skill yfinance-mthli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yfinance, lxml, pandas, and includes scripts (resource) and references (resource) components.

What problem does it solve?

yfinance eliminates the manual effort of looking up stock, ETF, and fundamental data by retrieving quotes, historical bars, fundamentals, analyst views, earnings, options, holdings, and SEC filings in a consistent structured way.

Core Features & Use Cases

  • Unified market-data retrieval: Get current quotes, historical OHLCV (including intraday and corporate-action events), and news for multiple asset types.
  • Fundamentals & analyst coverage: Pull company profiles and valuation metrics, plus analyst recommendations, target changes, and consensus earnings estimates.
  • Event discovery and investment research: Find market-wide earnings/IPO/splits/economic calendars, screen tickers, and drill into ownership, insider activity, options chains, and fund holdings.

Quick Start

Use the yfinance skill to answer “What is AAPL trading at, what is its YTD performance, and what’s its P/E ratio?” by requesting a current quote, YTD history summary, and valuation snapshot.

Frequently Asked Questions about yfinance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fetch Yahoo Finance market data and fundamentals for multiple stock tickers?

To fetch Yahoo Finance market data and fundamentals, use this skill to retrieve current quotes, historical OHLCV bars, company profiles, and valuation metrics for stocks, ETFs, and indexes in structured JSON or CSV format.

What's the best way to pull analyst consensus estimates and earnings calendars for investment research?

For investment research, this skill pulls analyst consensus estimates, target changes, and market-wide earnings calendars directly, providing structured outputs to streamline your event discovery and analysis.

Can I retrieve historical options chains and corporate-action events using yfinance?

Yes, you can retrieve historical options chains and corporate-action events using the yfinance-backed implementation, which supports per-ticker modes for options data and events-only historical bar retrieval.

Does this tool support fetching SEC filings, fund holdings, and insider ownership data?

Yes, this tool supports fetching SEC filings, fund holdings, and insider ownership data through dedicated per-ticker modes, delivering structured JSON or NDJSON outputs for comprehensive fundamental analysis.

How are ambiguous ticker symbols or failed data requests handled when fetching market data?

Ambiguous ticker symbols and failed data requests are handled via quote-type sniffing and retry/error classification, ensuring the skill returns accurate structured data or properly classified errors without crashing.