pandas-datareader

June 23, 2026 ยท View on GitHub

Macroeconomic and factor-oriented remote data access for pandas.

CI Testing PyPI Codecov RTD Code Style License

Installation

Install using pip

pip install pandas-datareader

Usage

import pandas_datareader as pdr
pdr.get_data_fred('GS10')

The public API is focused on macroeconomic, policy, and factor-style data sources such as FRED, Fama/French, Bank of Canada, World Bank, OECD, Eurostat, and the new pandas_datareader.macro interface.

Documentation

Stable documentation is available on github.io. A second copy of the stable documentation is hosted on read the docs for more details.

Development documentation is available for the latest changes in master.

Requirements

Using pandas datareader requires the following packages:

  • pandas>=1.5.3
  • lxml
  • requests>=2.19.0
  • distutils (not included in standard library of Python 3.12 and above it, which can be solved by installing setuptools)

Building the documentation additionally requires:

  • matplotlib
  • ipython
  • requests_cache
  • sphinx
  • pydata_sphinx_theme

Development and testing additionally requires:

  • black
  • coverage
  • codecov
  • coveralls
  • flake8
  • pytest
  • pytest-cov
  • wrapt

Install latest development version

python -m pip install git+https://github.com/pydata/pandas-datareader.git

or

git clone https://github.com/pydata/pandas-datareader.git
cd pandas-datareader
python -m pip install -e .