alpha-vantage

Alpha Vantage — 金融数据 API

⚠️ 重要：需要免费 API Key。请参阅“身份验证”部分。

覆盖全球（20 多家交易所、200,000 多个代码）的金融数据 API。

基础 URL： https://www.alphavantage.co/query
完整文档： alphavantage.co/documentation

---

身份验证

获取 API Key（免费）

1. 前往：https://www.alphavantage.co/support/#api-key
2. 填写表单（邮箱、姓名、用途类型）
3. 立即通过邮件收到 key
4. 无需信用卡

使用 API Key

import os
API_KEY = os.getenv("ALPHAVANTAGE_API_KEY")  # Recomendado
# o directamente:
API_KEY = "TU_API_KEY_AQUI"

⚠️ 切勿将 API key 硬编码在要分享或提交的代码中。

---

速率限制

计划	请求数/天	请求数/分钟	价格
免费	25	5	$0
Standard	∞	75	$49.99/月
Premium	∞	150	$99.99/月
Enterprise	∞	1,200	$249.99/月

免费套餐建议

• 缓存响应——数据不会频繁变化
• 使用 outputsize=compact——返回最近 100 条数据（免费）
• 不要在每次用户请求时都调用
• 请求之间等待 12 秒以上（最多 5 次请求/分钟）

如果达到限额

API 会返回：

{
  "Error Message": "Thank you for using Alpha Vantage! Our standard API call frequency is 5 requests per minute and 25 requests per day. Please subscribe to a premium plan for higher API call volume."
}

---

可用端点

时间序列——股票（免费套餐）

Function	描述	备注
TIME_SERIES_DAILY	每日 OHLCV	⚠️ 仅支持 compact（100 条数据）
TIME_SERIES_WEEKLY	每周 OHLCV	完整历史数据
TIME_SERIES_MONTHLY	每月 OHLCV	完整历史数据
GLOBAL_QUOTE	最新价格报价	快速
SYMBOL_SEARCH	搜索代码

时间序列——高级版

Function	描述
TIME_SERIES_INTRADAY	盘中数据（1/5/15/30/60 分钟）
TIME_SERIES_DAILY_ADJUSTED	包含拆股/股息调整
outputsize=full	完整历史数据（20 多年）

基本面数据（免费套餐）

Function	描述
OVERVIEW	公司概览
INCOME_STATEMENT	损益表
BALANCE_SHEET	资产负债表
CASH_FLOW	现金流
EARNINGS	历史收益

外汇（免费套餐）

Function	描述
CURRENCY_EXCHANGE_RATE	当前汇率
FX_INTRADAY	盘中外汇数据
FX_DAILY	每日外汇数据
FX_WEEKLY	每周外汇数据
FX_MONTHLY	每月外汇数据

加密货币（免费套餐）

Function	描述
CURRENCY_EXCHANGE_RATE	加密货币兑法币
DIGITAL_CURRENCY_DAILY	每日加密货币数据
DIGITAL_CURRENCY_WEEKLY	每周加密货币数据
DIGITAL_CURRENCY_MONTHLY	每月加密货币数据

技术指标（免费套餐提供 50 多种）

完整列表请参阅 ./references/indicators.md：

类别	指标
趋势	SMA、EMA、WMA、DEMA、TEMA、KAMA 等
动量	RSI、MACD、STOCH、WILLR、ADX、CCI 等
波动率	BBANDS、ATR、NATR、TRANGE
成交量	OBV、AD、ADOSC

经济指标（免费套餐）

Function	描述
REAL_GDP	美国 GDP
CPI	消费者价格指数
INFLATION	通胀率
UNEMPLOYMENT	失业率
FEDERAL_FUNDS_RATE	联邦基金利率
TREASURY_YIELD	国债收益率

Alpha Intelligence（免费套餐）

Function	描述	备注
NEWS_SENTIMENT	情绪分析	免费
TOP_GAINERS_LOSERS	涨幅最大/跌幅最大	免费
INSIDER_TRANSACTIONS	内部人士交易	⚠️ 高级版
ANALYTICS_FIXED_WINDOW	高级分析	⚠️ 高级版

---

使用示例

当前报价（最简单）

import requests

url = "https://www.alphavantage.co/query"
params = {
    "function": "GLOBAL_QUOTE",
    "symbol": "AAPL",
    "apikey": API_KEY
}
r = requests.get(url, params=params)
quote = r.json()["Global Quote"]
print(f"AAPL: ${quote['05. price']}")

每日时间序列

params = {
    "function": "TIME_SERIES_DAILY",
    "symbol": "IBM",
    "outputsize": "compact",  # últimos 100 días (free)
    "apikey": API_KEY
}
r = requests.get(url, params=params)
data = r.json()["Time Series (Daily)"]

技术指标（RSI）

params = {
    "function": "RSI",
    "symbol": "IBM",
    "interval": "daily",
    "time_period": 14,
    "apikey": API_KEY
}

外汇

params = {
    "function": "CURRENCY_EXCHANGE_RATE",
    "from_currency": "BTC",
    "to_currency": "USD",
    "apikey": API_KEY
}

---

下载脚本

使用 ./scripts/ 中的脚本：

# Descargar quotes de múltiples símbolos
python ./scripts/download_quotes.py --symbols AAPL,GOOGL,MSFT --output data/

# Descargar time series diarios
python ./scripts/download_timeseries.py --symbol AAPL --output data/

# Descargar indicadores técnicos
python ./scripts/download_indicators.py --symbol AAPL --indicator RSI --output data/

---

常见错误

错误	原因	解决方案
“每分钟 5 次请求”	速率限制	等待 12 秒以上
“每天 25 次请求”	每日限制	等待 24 小时或升级
“无效的 API 调用”	符号不存在	先使用 SYMBOL_SEARCH
响应中出现“高级版”	高级版端点	使用免费替代方案或升级