Welcome to alpha_vantage’s documentation!

Build Status PyPI version Documentation Status

Python module to get stock data from the Alpha Vantage API Alpha Vantage http://www.alphavantage.co/ is a free JSON APIs for stock market data, plus a comprehensive set of technical indicators. This project is a python wrapper around this API to offer python plus json/pandas support. I hope you enjoy it. It requires a free API, that can be requested on http://www.alphavantage.co/support/#api-key.


To install the package use:

pip install alpha_vantage

If you want to install from source, then use:

git clone https://github.com/RomelTorres/alpha_vantage.git
pip install -e alpha_vantage

Usage Example

This is a simple code snippet to get global quotes from the

from alpha_vantage.timeseries import TimeSeries
import matplotlib.pyplot as plt

ts = TimeSeries(key='YOUR_API_KEY', output_format='pandas')
data, meta_data = ts.get_intraday(symbol='MSFT',interval='1min', outputsize='full')
plt.title('Intraday Times Series for the MSFT stock (1 min)')

Code & Issue Tracker

The code is hosted in github: https://github.com/RomelTorres/alpha_vantage And the issue tracker as well: https://github.com/RomelTorres/alpha_vantage/issues


If you have a feature that you want to see merged in the code, please do a pull request with it and it will be evaluated.


This project is licensed under the MIT license.


Indices and tables


To find out more about the available api calls, visit the alpha-vantage documentation at http://www.alphavantage.co/documentation/