finance-datareader

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 on this page — 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

finance-datareader on PyPI

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

Evidence: finance_datareader-0.9.202-py3-none-any.whl

Keywords: data, finance

Tags

More Information Analysis packages