Skip to main content

ARCH for Python

Project description

Autoregressive Conditional Heteroskedasticity (ARCH) and other tools for financial econometrics, written in Python (with Cython and/or Numba used to improve performance)

Continuous Integration

Travis Build Status Appveyor Build Status


Documentation Status


Coverage Status codecov

Code Inspections

Code Quality: Python Total Alerts Codacy Badge codebeat badge




Released documentation is hosted on read the docs. Current documentation from the master branch is hosted on my github pages.

More about ARCH

More information about ARCH and related models is available in the notes and research available at Kevin Sheppard’s site.


Contributions are welcome. There are opportunities at many levels to contribute:

  • Implement new volatility process, e.g FIGARCH
  • Improve docstrings where unclear or with typos
  • Provide examples, preferably in the form of IPython notebooks


Volatility Modeling

  • Mean models
    • Constant mean
    • Heterogeneous Autoregression (HAR)
    • Autoregression (AR)
    • Zero mean
    • Models with and without exogenous regressors
  • Volatility models
    • ARCH
    • GARCH
    • TARCH
    • EGARCH
    • EWMA/RiskMetrics
  • Distributions
    • Normal
    • Student’s T
    • Generalized Error Distribution

See the univariate volatility example notebook for a more complete overview.

import datetime as dt
import as web
st = dt.datetime(1990,1,1)
en = dt.datetime(2014,1,1)
data = web.get_data_yahoo('^FTSE', start=st, end=en)
returns = 100 * data['Adj Close'].pct_change().dropna()

from arch import arch_model
am = arch_model(returns)
res =

Unit Root Tests

  • Augmented Dickey-Fuller
  • Dickey-Fuller GLS
  • Phillips-Perron
  • KPSS
  • Variance Ratio tests

See the unit root testing example notebook for examples of testing series for unit roots.


  • Bootstraps
    • IID Bootstrap
    • Stationary Bootstrap
    • Circular Block Bootstrap
    • Moving Block Bootstrap
  • Methods
    • Confidence interval construction
    • Covariance estimation
    • Apply method to estimate model across bootstraps
    • Generic Bootstrap iterator

See the bootstrap example notebook for examples of bootstrapping the Sharpe ratio and a Probit model from Statsmodels.

# Import data
import datetime as dt
import pandas as pd
import as web
start = dt.datetime(1951,1,1)
end = dt.datetime(2014,1,1)
sp500 = web.get_data_yahoo('^GSPC', start=start, end=end)
start = sp500.index.min()
end = sp500.index.max()
monthly_dates = pd.date_range(start, end, freq='M')
monthly = sp500.reindex(monthly_dates, method='ffill')
returns = 100 * monthly['Adj Close'].pct_change().dropna()

# Function to compute parameters
def sharpe_ratio(x):
    mu, sigma = 12 * x.mean(), np.sqrt(12 * x.var())
    return np.array([mu, sigma, mu / sigma])

# Bootstrap confidence intervals
from arch.bootstrap import IIDBootstrap
bs = IIDBootstrap(returns)
ci = bs.conf_int(sharpe_ratio, 1000, method='percentile')

Multiple Comparison Procedures

  • Test of Superior Predictive Ability (SPA), also known as the Reality Check or Bootstrap Data Snooper
  • Stepwise (StepM)
  • Model Confidence Set (MCS)

See the multiple comparison example notebook for examples of the multiple comparison procedures.


These requirements reflect the testing environment. It is possible that arch will work with older versions.

  • Python (2.7, 3.5 - 3.7)
  • NumPy (1.13+)
  • SciPy (0.19+)
  • Pandas (0.21+)
  • statsmodels (0.8+)
  • matplotlib (2.0+)

Optional Requirements

  • Numba (0.35+) will be used if available and when installed using the –no-binary option
  • Jupyter is required to run the notebooks


  • Cython (0.24+, if not using –no-binary)
  • py.test (For tests)
  • sphinx (to build docs)
  • guzzle_sphinx_theme (to build docs)
  • jupyter and notebook (to build docs)
  • numpydoc (to build docs)

Note: Setup does not verify requirements. Please ensure these are installed.


Releases are available PyPI.

pip install arch

This command should work whether you have a compiler installed or not. If you want to install with the --no-binary options, call

pip install arch --install-option="--no-binary"

You can alternatively install the latest version from GitHub

pip install git+


conda install arch -c bashtage


Building extension using the community edition of Visual Studio is well supported for Python 3.5+. Building extensions for 64-bit Windows for use in Python 2.7 is also supported using Microsoft Visual C++ Compiler for Python 2.7. Building on other combinations of Python/Windows is more difficult and is not necessary when Numba is installed since just-in-time compiled code (Numba) runs as fast as ahead-of-time compiled extensions.

With a compiler

If you are comfortable compiling binaries on Windows:

pip install git+

No Compiler

All binary code is backed by a pure Python implementation. Compiling can be skipped using the flag --no-binary

pip install git+ --install-option "--no-binary"

Note: If Cython is not installed, the package will be installed as-if –no-binary was used.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
arch-4.6.0-cp27-cp27m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (541.7 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp27-cp27m-manylinux1_i686.whl (530.8 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp27-cp27m-manylinux1_x86_64.whl (552.2 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp27-cp27mu-manylinux1_i686.whl (531.0 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp27-cp27mu-manylinux1_x86_64.whl (552.3 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp27-cp27m-win32.whl (256.2 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp27-cp27m-win_amd64.whl (282.8 kB) Copy SHA256 hash SHA256 Wheel cp27
arch-4.6.0-cp35-cp35m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (525.1 kB) Copy SHA256 hash SHA256 Wheel cp35
arch-4.6.0-cp35-cp35m-manylinux1_i686.whl (521.2 kB) Copy SHA256 hash SHA256 Wheel cp35
arch-4.6.0-cp35-cp35m-manylinux1_x86_64.whl (541.4 kB) Copy SHA256 hash SHA256 Wheel cp35
arch-4.6.0-cp35-cp35m-win32.whl (246.5 kB) Copy SHA256 hash SHA256 Wheel cp35
arch-4.6.0-cp35-cp35m-win_amd64.whl (272.1 kB) Copy SHA256 hash SHA256 Wheel cp35
arch-4.6.0-cp36-cp36m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (528.0 kB) Copy SHA256 hash SHA256 Wheel cp36
arch-4.6.0-cp36-cp36m-manylinux1_i686.whl (522.5 kB) Copy SHA256 hash SHA256 Wheel cp36
arch-4.6.0-cp36-cp36m-manylinux1_x86_64.whl (543.8 kB) Copy SHA256 hash SHA256 Wheel cp36
arch-4.6.0-cp36-cp36m-win32.whl (247.5 kB) Copy SHA256 hash SHA256 Wheel cp36
arch-4.6.0-cp36-cp36m-win_amd64.whl (273.0 kB) Copy SHA256 hash SHA256 Wheel cp36
arch-4.6.0-cp37-cp37m-macosx_10_6_intel.macosx_10_9_intel.macosx_10_9_x86_64.macosx_10_10_intel.macosx_10_10_x86_64.whl (528.0 kB) Copy SHA256 hash SHA256 Wheel cp37
arch-4.6.0-cp37-cp37m-manylinux1_i686.whl (521.9 kB) Copy SHA256 hash SHA256 Wheel cp37
arch-4.6.0-cp37-cp37m-manylinux1_x86_64.whl (543.1 kB) Copy SHA256 hash SHA256 Wheel cp37
arch-4.6.0-cp37-cp37m-win32.whl (247.2 kB) Copy SHA256 hash SHA256 Wheel cp37
arch-4.6.0-cp37-cp37m-win_amd64.whl (272.6 kB) Copy SHA256 hash SHA256 Wheel cp37
arch-4.6.0.tar.gz (378.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page