alpha-vantage

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Alpha Vantage — Financial Data API

Alpha Vantage — 金融数据API

⚠️ IMPORTANTE: Requiere API Key gratuita. Ver sección de Autenticación.

API de datos financieros con cobertura global (20+ bolsas, 200,000+ tickers).

Base URL:

https://www.alphavantage.co/query

Documentación completa: alphavantage.co/documentation

⚠️ 重要提示：需要免费API Key。请查看认证部分。

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

基础URL：

https://www.alphavantage.co/query

完整文档： alphavantage.co/documentation

Autenticación

认证

Obtener API Key (GRATIS)

获取免费API Key

Ir a: https://www.alphavantage.co/support/#api-key
Completar el formulario (email, nombre, tipo de uso)
Recibir key instantáneamente por email
No requiere tarjeta de crédito

访问：https://www.alphavantage.co/support/#api-key
填写表单（邮箱、姓名、使用类型）
立即通过邮箱收到密钥
无需信用卡

Usar la API Key

使用API Key

python

import os
API_KEY = os.getenv("ALPHAVANTAGE_API_KEY")  # Recomendado

python

import os
API_KEY = os.getenv("ALPHAVANTAGE_API_KEY")  # 推荐方式

o directamente:

或者直接设置：

API_KEY = "TU_API_KEY_AQUI"


**⚠️ NUNCA hardcodear la API key en código que se va a compartir/commits.**

---

API_KEY = "你的API_KEY在此处"


**⚠️ 绝对不要在将被分享/提交的代码中硬编码API key。**

---

Rate Limits

请求限制

Plan	Requests/Día	Requests/Minuto	Precio
Free	25	5	$0
Standard	∞	75	$49.99/mes
Premium	∞	150	$99.99/mes
Enterprise	∞	1,200	$249.99/mes

套餐	每日请求次数	每分钟请求次数	价格
免费版	25	5	$0
标准版	无限	75	$49.99/月
高级版	无限	150	$99.99/月
企业版	无限	1,200	$249.99/月

Recomendaciones para Free Tier

免费版使用建议

Cachear respuestas — los datos no cambian frecuentemente
Usar
outputsize=compact
— retorna últimos 100 datos (gratis)
No hacer llamadas en cada request de usuario
Esperar 12+ segundos entre requests (5 req/min máximo)

缓存响应 — 数据不会频繁变动
使用
outputsize=compact
— 返回最近100条数据（免费）
不要在每次用户请求时都调用API
请求间隔至少12秒（最多5次请求/分钟）

Si llegás al límite

达到限制时的返回内容

El API retorna:

json

{
  "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."
}

API会返回：

json

{
  "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."
}

Endpoints Disponibles

可用接口

Time Series — Acciones (Free Tier)

时间序列 — 股票（免费版）

Function	Descripción	Notas
`TIME_SERIES_DAILY`	OHLCV diario	⚠️ Solo `compact` (100 datos)
`TIME_SERIES_WEEKLY`	OHLCV semanal	Full history
`TIME_SERIES_MONTHLY`	OHLCV mensual	Full history
`GLOBAL_QUOTE`	Quote último precio	Rápido
`SYMBOL_SEARCH`	Buscar símbolos

函数	描述	说明
`TIME_SERIES_DAILY`	每日OHLCV数据	⚠️ 仅支持 `compact` （100条数据）
`TIME_SERIES_WEEKLY`	每周OHLCV数据	完整历史
`TIME_SERIES_MONTHLY`	每月OHLCV数据	完整历史
`GLOBAL_QUOTE`	最新报价	响应快速
`SYMBOL_SEARCH`	搜索交易代码

Time Series — PREMIUM

时间序列 — 付费版

Function	Descripción
`TIME_SERIES_INTRADAY`	Datos intraday (1/5/15/30/60 min)
`TIME_SERIES_DAILY_ADJUSTED`	Con splits/dividendos
`outputsize=full`	Historia completa (20+ años)

函数	描述
`TIME_SERIES_INTRADAY`	日内数据（1/5/15/30/60分钟）
`TIME_SERIES_DAILY_ADJUSTED`	包含拆股/分红数据
`outputsize=full`	完整历史（20+年）

Fundamental Data (Free Tier)

基本面数据（免费版）

Function	Descripción
`OVERVIEW`	Company overview
`INCOME_STATEMENT`	Estado de resultados
`BALANCE_SHEET`	Balance general
`CASH_FLOW`	Flujo de caja
`EARNINGS`	Ganancias históricas

函数	描述
`OVERVIEW`	公司概况
`INCOME_STATEMENT`	利润表
`BALANCE_SHEET`	资产负债表
`CASH_FLOW`	现金流量表
`EARNINGS`	历史收益

Forex (Free Tier)

外汇（免费版）

Function	Descripción
`CURRENCY_EXCHANGE_RATE`	Tipo de cambio actual
`FX_INTRADAY`	Intraday forex
`FX_DAILY`	Forex diario
`FX_WEEKLY`	Forex semanal
`FX_MONTHLY`	Forex mensual

函数	描述
`CURRENCY_EXCHANGE_RATE`	当前汇率
`FX_INTRADAY`	日内外汇数据
`FX_DAILY`	每日外汇数据
`FX_WEEKLY`	每周外汇数据
`FX_MONTHLY`	每月外汇数据

Cryptocurrency (Free Tier)

加密货币（免费版）

Function	Descripción
`CURRENCY_EXCHANGE_RATE`	Crypto vs fiat
`DIGITAL_CURRENCY_DAILY`	Crypto diario
`DIGITAL_CURRENCY_WEEKLY`	Crypto semanal
`DIGITAL_CURRENCY_MONTHLY`	Crypto mensual

函数	描述
`CURRENCY_EXCHANGE_RATE`	加密货币vs法定货币
`DIGITAL_CURRENCY_DAILY`	每日加密货币数据
`DIGITAL_CURRENCY_WEEKLY`	每周加密货币数据
`DIGITAL_CURRENCY_MONTHLY`	每月加密货币数据

Technical Indicators (50+ Free Tier)

技术指标（50+种，免费版）

Ver lista completa en ./references/indicators.md:

Categoría	Indicadores
Trend	SMA, EMA, WMA, DEMA, TEMA, KAMA, etc.
Momentum	RSI, MACD, STOCH, WILLR, ADX, CCI, etc.
Volatility	BBANDS, ATR, NATR, TRANGE
Volume	OBV, AD, ADOSC

完整列表请查看./references/indicators.md:

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

Economic Indicators (Free Tier)

经济指标（免费版）

Function	Descripción
`REAL_GDP`	PIB de EE.UU.
`CPI`	Índice de Precios al Consumidor
`INFLATION`	Tasa de inflación
`UNEMPLOYMENT`	Tasa de desempleo
`FEDERAL_FUNDS_RATE`	Tasa de fondos federales
`TREASURY_YIELD`	Rendimientos del tesoro

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

Alpha Intelligence (Free Tier)

Alpha Intelligence（免费版）

Function	Descripción	Notas
`NEWS_SENTIMENT`	Análisis de sentimiento	Free
`TOP_GAINERS_LOSERS`	Mejores/peores	Free
`INSIDER_TRANSACTIONS`	Transacciones insiders	⚠️ PREMIUM
`ANALYTICS_FIXED_WINDOW`	Analytics avanzado	⚠️ PREMIUM

函数	描述	说明
`NEWS_SENTIMENT`	情绪分析	免费
`TOP_GAINERS_LOSERS`	涨跌榜	免费
`INSIDER_TRANSACTIONS`	内幕交易	⚠️ 付费版
`ANALYTICS_FIXED_WINDOW`	高级分析	⚠️ 付费版

Ejemplos de Uso

使用示例

Quote actual (más simple)

获取最新报价（最简单）

python

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']}")

python

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']}")

Time Series Diario

每日时间序列数据

python

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)"]

python

params = {
    "function": "TIME_SERIES_DAILY",
    "symbol": "IBM",
    "outputsize": "compact",  # 最近100天数据（免费版）
    "apikey": API_KEY
}
r = requests.get(url, params=params)
data = r.json()["Time Series (Daily)"]

Indicador Técnico (RSI)

技术指标（RSI）

python

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

python

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

Forex

外汇数据

python

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

python

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

Scripts de Descarga

下载脚本

Usá los scripts en ./scripts/:

bash

undefined

使用./scripts/目录下的脚本：

bash

undefined

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/

---

python ./scripts/download_indicators.py --symbol AAPL --indicator RSI --output data/

---

Errores Comunes

常见错误

Error	Causa	Solución
"5 requests per minute"	Rate limit	Esperar 12+ segundos
"25 requests per day"	Daily limit	Esperar 24 horas o upgrade
"Invalid API call"	Symbol no existe	Usar `SYMBOL_SEARCH` primero
"premium" en response	Endpoint premium	Usar alternativa free o upgrade

错误信息	原因	解决方案
"5 requests per minute"	请求频率超限	等待至少12秒
"25 requests per day"	每日请求次数超限	等待24小时或升级套餐
"Invalid API call"	交易代码不存在	先使用 `SYMBOL_SEARCH` 搜索
响应中包含"premium"	访问了付费接口	使用免费替代接口或升级套餐