pandas-datareader

0.10.0 · active · verified Mon Apr 13

Data readers extracted from the pandas codebase, pandas-datareader provides up-to-date remote data access for various financial and economic data sources, compatible with recent pandas versions. The library's release cadence is irregular, largely influenced by the frequent changes in external data provider APIs which often require rapid updates to its readers.

Warnings

breaking Dropped support for Python 2.7 in v0.9.0. The minimum required Python version is now 3.6.
Fix: Upgrade your Python environment to 3.6 or newer. Python 3.8+ is recommended.
breaking IEX Cloud API Key Requirement: From v0.8.0, all IEX readers require an API token (`IEX_API_KEY`).
Fix: Register for an API key on IEX Cloud and set it as an environment variable (e.g., `os.environ["IEX_API_KEY"] = "pk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"`) or pass it directly to the reader.
breaking Removal or immediate deprecation of several data sources: Google Finance, Morningstar, and Robinhood were removed (deprecated in v0.7.0, removed in v0.8.0, Robinhood removed in v0.9.0). The AlphaVantage quote reader and Enigma were immediately deprecated in v0.9.0 due to API changes or service termination.
Fix: Switch to alternative data sources or use a different library if these specific sources are critical to your workflow.
gotcha Yahoo Finance reader instability: The Yahoo Finance API is prone to frequent, unannounced changes, often leading to `RemoteDataError` or incorrect data. While v0.10.0 included fixes for Yahoo readers, it remains a common point of failure for users.
Fix: Ensure you are on the latest `pandas-datareader` version. If issues persist, consider using the `yfinance` library directly or another robust financial data provider.
gotcha General API instability and lack of frequent updates: Many data sources continuously change their APIs, causing readers in `pandas-datareader` to break. There is an acknowledged challenge in maintaining all readers, leading to periods where certain data sources may not function correctly between releases.
Fix: Check the project's GitHub issues for known broken readers. For critical data, consider direct API integration or using dedicated client libraries for specific data providers.
gotcha Potential incompatibility with Pandas 3.0: There are indications of anticipated breaking changes related to `pandas` 3.0. Users upgrading `pandas` to version 3.0 or higher may encounter issues.
Fix: Monitor `pandas-datareader` GitHub issues and releases for updates on `pandas` 3.0 compatibility. Consider pinning your `pandas` version to a compatible older release if you encounter problems.

Install

pip install pandas-datareader Install stable version

Imports

DataReader
```
from pandas_datareader.data import DataReader
```
DataReader was moved out of pandas into its own library in pandas v0.19.0.
pandas_datareader as pdr
```
import pandas_datareader as pdr
```
Common alias for the top-level module functions like get_data_fred.
pandas_datareader.data as web
```
import pandas_datareader.data as web
```
Common alias for the data submodule containing DataReader and various source-specific readers.

Quickstart

This example fetches the 10-Year Treasury Constant Maturity Rate (GS10) from FRED (Federal Reserve Economic Data) for a specified date range and prints the first few rows. FRED is generally reliable and does not require an API key for basic usage.

import pandas_datareader.data as web
import datetime

start = datetime.datetime(2020, 1, 1)
end = datetime.datetime(2023, 1, 1)

# Fetch data from FRED (Federal Reserve Economic Data)
gs10 = web.DataReader('GS10', 'fred', start, end)

print(gs10.head())

view raw JSON →