# Yfinance

> Yahoo Finance market data downloader. Stock prices, options chains, fundamentals, dividends, splits, earnings, institutional holders, and financial statements. Quick data ingestion for quant research and backtesting.

- Skill: `mkurman/yfinance` (Agent Skill)
- Install (CLI): `npx skillmds@latest add mkurman/yfinance`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mkurman/yfinance/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: mkurman (https://skillmd.com/u/mkurman)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/mkurman/yfinance

---

## Overview

yfinance downloads Yahoo Finance market data: stock prices, options chains, fundamentals, dividends, splits, earnings, institutional holders, and financial statements. The fastest path from ticker symbol to pandas DataFrame for quant research and backtesting.

## Installation

```bash
uv pip install yfinance
```

## Price History

```python
import yfinance as yf

msft = yf.download("MSFT", start="2024-01-01", end="2024-12-31")
print(msft.head())
```

## Fundamentals & Financials

```python
ticker = yf.Ticker("AAPL")
info = ticker.info
print(f"Market cap: {info['marketCap']:,}")
print(f"PE ratio: {info['trailingPE']}")
print(f"Dividend yield: {info.get('dividendYield', 0)*100:.2f}%")
print(ticker.balance_sheet)
print(ticker.financials)
```

## Options

```python
opt = ticker.option_chain(ticker.options[0])
print(opt.calls[["strike", "lastPrice", "impliedVolatility", "volume"]].head())
print(opt.puts[["strike", "lastPrice", "impliedVolatility", "volume"]].head())
```

## References
- [yfinance GitHub](https://github.com/ranaroussi/yfinance)