---
id: alpha-vantage
version: "3.0.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# alpha-vantage — Python module to get stock data from the Alpha Vantage Api

License: permissive · Maintenance: active · Downloads: 233.7K/mo

## What it is and what it does

Alpha Vantage is a Python wrapper around the free Alpha Vantage financial data API. It lets you retrieve real-time and historical stock prices, cryptocurrency rates, forex exchange rates, and technical indicators (like moving averages and Bollinger Bands) in a format you can work with directly—JSON dictionaries, pandas DataFrames, or CSV. The library handles API authentication, retries, and response parsing so you don't have to.

It's built for developers who want to integrate live financial market data into Python applications without building HTTP calls from scratch. You can query intraday, daily, or weekly data; pull technical indicators for analysis; or fetch fundamental company data. Pandas support is optional, so you can use it for lightweight scripts or integrate it into larger data pipelines. The library supports both standard Alpha Vantage keys and rapidAPI keys.

Use it for:

- Build a stock price monitoring dashboard that pulls live OHLC data and plots it with matplotlib.
- Backtest trading strategies by fetching historical intraday or daily price data for multiple symbols.
- Calculate technical indicators (SMA, RSI, Bollinger Bands) on demand for charting or algorithmic analysis.
- Track cryptocurrency prices across different market pairs and export to pandas for statistical analysis.
- Integrate real-time forex exchange rates into a financial application without managing raw HTTP requests.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Fetches real-time and historical stock, cryptocurrency, forex, and technical indicator data from the Alpha Vantage API, returning results as JSON, pandas DataFrames, or CSV.

Yes. The package is actively maintained, has no known vulnerabilities, installs with minimal friction, and uses a permissive MIT license. It's a straightforward wrapper around a free API with broad financial data coverage. Install it if you need to pull stock, crypto, or forex data into Python; skip it only if you prefer lower-level HTTP control or a different data source.

## Install

pip install alpha-vantage
uv add alpha-vantage
poetry add alpha-vantage

## Installing alpha-vantage

Before you install: Low friction install with only two runtime dependencies (aiohttp and requests). Actively maintained with recent commits and a stable production release status.

License in practice: MIT license permits commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart:

pip install alpha_vantage

from alpha_vantage.timeseries import TimeSeries
ts = TimeSeries(key='YOUR_API_KEY')
data, meta_data = ts.get_intraday('GOOGL')

Requires a free API key from Alpha Vantage (http://www.alphavantage.co/support/#api-key); API calls are rate-limited.

Verify before relying:

- Whether asyncio support (mentioned as available from version 2.2.0) is fully documented and production-ready in current releases.
- Current rate limits and quota constraints for the free Alpha Vantage API tier.
- Whether pandas is truly optional or required for certain output formats despite being listed as optional.

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 233.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

stock market data api, cryptocurrency price data, technical indicators, financial data fetching, alpha vantage python wrapper, forex currency exchange, intraday stock quotes, financial-data, api-wrapper, market-data

[View on SkillFed](https://skillfed.io/packages/alpha-vantage) · [View on PyPI](https://pypi.org/project/alpha-vantage/)