---
id: finance-datareader
version: "0.9.202"
license: MIT License
license_treatment: permissive
maintenance: active
---

# finance-datareader — Financial data reader (price, stock list of markets)

License: permissive · Maintenance: active · Downloads: 265.3K/mo

## What it is and what it does

FinanceDataReader is a financial data crawler that retrieves stock prices, market indices, exchange rates, and cryptocurrency data from global exchanges—KRX (Korean), NASDAQ, NYSE, S&P 500, Shanghai, Shenzhen, Hong Kong, Tokyo, and Ho Chi Minh exchanges. It wraps web scraping and API calls behind a simple pandas-centric interface, returning time-series data as DataFrames. The package includes both a Python library (via `fdr.DataReader()`) and a CLI tool (`fdr` command) for terminal-based queries.

It depends on beautifulsoup4, lxml, pandas, requests, and plotly to parse HTML, fetch data, and structure results. The library handles symbol resolution across markets (e.g., 'AAPL' for US stocks, '005930' for Samsung, 'KS11' for KOSPI index) and supports date-range filtering. It is production-stable, actively maintained, and requires Python 3.9 or later.

Use it for:

- Backtest trading strategies by fetching historical stock prices for multiple symbols and date ranges.
- Build financial dashboards that display real-time or recent index values (KOSPI, NASDAQ, S&P 500) and exchange rates.
- Analyze cryptocurrency price trends by retrieving BTC/KRW, ETH/USD, and other crypto pairs over time.
- Screen Korean stocks by listing all KRX symbols and fetching their price history for fundamental analysis.
- Monitor delisted or administratively suspended Korean stocks via KRX-DELISTING and KRX-ADMIN listings.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Fetches historical and current financial data—stock prices, indices, exchange rates, and cryptocurrency—from multiple global exchanges and returns it as pandas DataFrames.

Yes. Low install friction, no security vulnerabilities, active maintenance, and permissive MIT license. Install if you need to fetch financial time-series data from multiple global exchanges into pandas DataFrames. Caveat: reliability depends on upstream data sources (web scraping); verify data accuracy for production use.

## Install

pip install finance-datareader
uv add finance-datareader
poetry add finance-datareader

## Installing finance-datareader

Before you install: Low friction: pure Python wheel with no compiled dependencies. Active maintenance—last commit 2026-05-13, 1531 GitHub stars. Supports Python 3.9 through 3.12.

License in practice: MIT License (permissive): you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install finance-datareader

import FinanceDataReader as fdr
df = fdr.DataReader('AAPL', '2024')  # Apple stock, 2024 to present
df = fdr.DataReader('KS11', '2024')  # KOSPI index
df = fdr.DataReader('USD/KRW')       # USD/KRW exchange rate

Verify before relying:

- Reliability and latency of data sources (web scraping may be fragile across market APIs).
- Whether all listed exchanges (SSE, SZSE, HKEX, TSE, HOSE) are consistently available.
- Rate limiting or throttling policies from upstream data providers.

## Package facts

- License: MIT License (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 265.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stock price data fetcher, financial data crawler, market index downloader, exchange rate historical data, cryptocurrency price reader, financial-data, market-data, web-scraper

[View on SkillFed](https://skillfed.io/packages/finance-datareader) · [View on PyPI](https://pypi.org/project/finance-datareader/)