Alpha Vantage — Financial Market Data
Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.
API Key Setup (Required)
- Get a free key at https://www.alphavantage.co/support/#api-key (premium plans available for higher rate limits)
- Set as environment variable:
read -rsp "Alpha Vantage API key: " ALPHAVANTAGE_API_KEY
echo
export ALPHAVANTAGE_API_KEY
Installation
uv pip install requests pandas
Base URL & Request Pattern
All requests go to:
https://www.alphavantage.co/query?function=FUNCTION_NAME&apikey=YOUR_KEY&...params
import requests
import os
API_KEY = os.environ.get("ALPHAVANTAGE_API_KEY")
BASE_URL = "https://www.alphavantage.co/query"
def av_get(function, **params):
response = requests.get(BASE_URL, params={"function": function, "apikey": API_KEY, **params})
return response.json()
Quick Start Examples
# Stock quote (latest price)
quote = av_get("GLOBAL_QUOTE", symbol="AAPL")
price = quote["Global Quote"]["05. price"]
# Daily OHLCV
daily = av_get("TIME_SERIES_DAILY", symbol="AAPL", outputsize="compact")
ts = daily["Time Series (Daily)"]
# Company fundamentals
overview = av_get("OVERVIEW", symbol="AAPL")
print(overview["MarketCapitalization"], overview["PERatio"])
# Income statement
income = av_get("INCOME_STATEMENT", symbol="AAPL")
annual = income["annualReports"][0] # Most recent annual
# Crypto price
crypto = av_get("DIGITAL_CURRENCY_DAILY", symbol="BTC", market="USD")
# Economic indicator
gdp = av_get("REAL_GDP", interval="annual")
# Technical indicator
rsi = av_get("RSI", symbol="AAPL", interval="daily", time_period=14, series_type="close")
API Categories
| Category |
Key Functions |
| Time Series (Stocks) |
GLOBAL_QUOTE, TIME_SERIES_INTRADAY, TIME_SERIES_DAILY, TIME_SERIES_WEEKLY, TIME_SERIES_MONTHLY |
| Options |
REALTIME_OPTIONS, HISTORICAL_OPTIONS |
| Alpha Intelligence |
NEWS_SENTIMENT, EARNINGS_CALL_TRANSCRIPT, TOP_GAINERS_LOSERS, INSIDER_TRANSACTIONS, ANALYTICS_FIXED_WINDOW |
| Fundamentals |
OVERVIEW, ETF_PROFILE, INCOME_STATEMENT, BALANCE_SHEET, CASH_FLOW, EARNINGS, DIVIDENDS, SPLITS |
| Forex (FX) |
CURRENCY_EXCHANGE_RATE, FX_INTRADAY, FX_DAILY, FX_WEEKLY, FX_MONTHLY |
| Crypto |
CURRENCY_EXCHANGE_RATE, CRYPTO_INTRADAY, DIGITAL_CURRENCY_DAILY |
| Commodities |
GOLD (WTI spot), BRENT, NATURAL_GAS, COPPER, WHEAT, CORN, COFFEE, ALL_COMMODITIES |
| Economic Indicators |
REAL_GDP, TREASURY_YIELD, FEDERAL_FUNDS_RATE, CPI, INFLATION, UNEMPLOYMENT, NONFARM_PAYROLL |
| Technical Indicators |
SMA, EMA, MACD, RSI, BBANDS, STOCH, ADX, ATR, OBV, VWAP, and 40+ more |
Common Parameters
| Parameter |
Values |
Notes |
outputsize |
compact / full |
compact = last 100 points; full = 20+ years |
datatype |
json / csv |
Default: json |
interval |
1min, 5min, 15min, 30min, 60min, daily, weekly, monthly |
Depends on endpoint |
adjusted |
true / false |
Adjust for splits/dividends |
Rate Limits
- Free tier: 25 requests/day (as of 2026)
- Premium plans: higher limits, real-time data, intraday access
- HTTP 429 = rate limit exceeded
- Add delays between requests when processing multiple symbols
import time
# Add delay to avoid rate limits
time.sleep(0.5) # 0.5s between requests on free tier
Error Handling
data = av_get("GLOBAL_QUOTE", symbol="AAPL")
# Check for API errors
if "Error Message" in data:
raise ValueError(f"API Error: {data['Error Message']}")
if "Note" in data:
print(f"Rate limit warning: {data['Note']}")
if "Information" in data:
print(f"API info: {data['Information']}")
When to Use
Use this skill when tackling tasks related to its primary domain or functionality as described above.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
1---2name: alpha-vantage3description: "Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators."4risk: critical5source: community6date_added: "2026-03-06"7metadata:8 source: https://skillmd.com/skills/iradoweck/alpha-vantage9 skill-author: K-Dense Inc.10---1112# Alpha Vantage — Financial Market Data1314Access 20+ years of global financial data: equities, options, forex, crypto, commodities, economic indicators, and 50+ technical indicators.1516## API Key Setup (Required)17181. Get a free key at https://www.alphavantage.co/support/#api-key (premium plans available for higher rate limits)192. Set as environment variable:2021```bash22read -rsp "Alpha Vantage API key: " ALPHAVANTAGE_API_KEY23echo24export ALPHAVANTAGE_API_KEY25```2627## Installation2829```bash30uv pip install requests pandas31```3233## Base URL & Request Pattern3435All requests go to:3637```38https://www.alphavantage.co/query?function=FUNCTION_NAME&apikey=YOUR_KEY&...params39```4041```python42import requests43import os4445API_KEY = os.environ.get("ALPHAVANTAGE_API_KEY")46BASE_URL = "https://www.alphavantage.co/query"4748def av_get(function, **params):49 response = requests.get(BASE_URL, params={"function": function, "apikey": API_KEY, **params})50 return response.json()51```5253## Quick Start Examples5455```python56# Stock quote (latest price)57quote = av_get("GLOBAL_QUOTE", symbol="AAPL")58price = quote["Global Quote"]["05. price"]5960# Daily OHLCV61daily = av_get("TIME_SERIES_DAILY", symbol="AAPL", outputsize="compact")62ts = daily["Time Series (Daily)"]6364# Company fundamentals65overview = av_get("OVERVIEW", symbol="AAPL")66print(overview["MarketCapitalization"], overview["PERatio"])6768# Income statement69income = av_get("INCOME_STATEMENT", symbol="AAPL")70annual = income["annualReports"][0] # Most recent annual7172# Crypto price73crypto = av_get("DIGITAL_CURRENCY_DAILY", symbol="BTC", market="USD")7475# Economic indicator76gdp = av_get("REAL_GDP", interval="annual")7778# Technical indicator79rsi = av_get("RSI", symbol="AAPL", interval="daily", time_period=14, series_type="close")80```8182## API Categories8384| Category | Key Functions |85|----------|--------------|86| **Time Series (Stocks)** | GLOBAL_QUOTE, TIME_SERIES_INTRADAY, TIME_SERIES_DAILY, TIME_SERIES_WEEKLY, TIME_SERIES_MONTHLY |87| **Options** | REALTIME_OPTIONS, HISTORICAL_OPTIONS |88| **Alpha Intelligence** | NEWS_SENTIMENT, EARNINGS_CALL_TRANSCRIPT, TOP_GAINERS_LOSERS, INSIDER_TRANSACTIONS, ANALYTICS_FIXED_WINDOW |89| **Fundamentals** | OVERVIEW, ETF_PROFILE, INCOME_STATEMENT, BALANCE_SHEET, CASH_FLOW, EARNINGS, DIVIDENDS, SPLITS |90| **Forex (FX)** | CURRENCY_EXCHANGE_RATE, FX_INTRADAY, FX_DAILY, FX_WEEKLY, FX_MONTHLY |91| **Crypto** | CURRENCY_EXCHANGE_RATE, CRYPTO_INTRADAY, DIGITAL_CURRENCY_DAILY |92| **Commodities** | GOLD (WTI spot), BRENT, NATURAL_GAS, COPPER, WHEAT, CORN, COFFEE, ALL_COMMODITIES |93| **Economic Indicators** | REAL_GDP, TREASURY_YIELD, FEDERAL_FUNDS_RATE, CPI, INFLATION, UNEMPLOYMENT, NONFARM_PAYROLL |94| **Technical Indicators** | SMA, EMA, MACD, RSI, BBANDS, STOCH, ADX, ATR, OBV, VWAP, and 40+ more |9596## Common Parameters9798| Parameter | Values | Notes |99|-----------|--------|-------|100| `outputsize` | `compact` / `full` | compact = last 100 points; full = 20+ years |101| `datatype` | `json` / `csv` | Default: json |102| `interval` | `1min`, `5min`, `15min`, `30min`, `60min`, `daily`, `weekly`, `monthly` | Depends on endpoint |103| `adjusted` | `true` / `false` | Adjust for splits/dividends |104105## Rate Limits106107- Free tier: 25 requests/day (as of 2026)108- Premium plans: higher limits, real-time data, intraday access109- HTTP 429 = rate limit exceeded110- Add delays between requests when processing multiple symbols111112```python113import time114# Add delay to avoid rate limits115time.sleep(0.5) # 0.5s between requests on free tier116```117118## Error Handling119120```python121data = av_get("GLOBAL_QUOTE", symbol="AAPL")122123# Check for API errors124if "Error Message" in data:125 raise ValueError(f"API Error: {data['Error Message']}")126if "Note" in data:127 print(f"Rate limit warning: {data['Note']}")128if "Information" in data:129 print(f"API info: {data['Information']}")130```131132133## When to Use134Use this skill when tackling tasks related to its primary domain or functionality as described above.135136## Limitations137- Use this skill only when the task clearly matches the scope described above.138- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.139- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.