Alpha Vantage 金融市场数据
访问超过 20 年的全球金融数据:涵盖股票、期权、外汇、加密货币、大宗商品、经济指标以及 50 多种技术指标。
准备工作 (必需)
- 在 alphavantage.co 获取免费 API Key。
- 设置环境变量:
export ALPHAVANTAGE_API_KEY="your_key"。
快速开始
所有的请求都发送至基础 URL:https://www.alphavantage.co/query。
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()
# 获取最新股价 (Apple)
quote = av_get("GLOBAL_QUOTE", symbol="AAPL")
price = quote["Global Quote"]["05. price"]
# 获取公司基本面总览
overview = av_get("OVERVIEW", symbol="AAPL")
print(overview["MarketCapitalization"], overview["PERatio"])
# 经济指标 (如 GDP)
gdp = av_get("REAL_GDP", interval="annual")
API 类别概览
| 类别 | 关键函数 (Function) | |----------|--------------| | 股票时间序列 | GLOBAL_QUOTE, TIME_SERIES_DAILY, TIME_SERIES_INTRADAY | | 公司基本面 | OVERVIEW, INCOME_STATEMENT, BALANCE_SHEET, CASH_FLOW, EARNINGS | | 智能情报 | NEWS_SENTIMENT, INSIDER_TRANSACTIONS, TOP_GAINERS_LOSERS | | 外汇与加密货币 | CURRENCY_EXCHANGE_RATE, FX_DAILY, DIGITAL_CURRENCY_DAILY | | 大宗商品 | GOLD, WTI (原油), BRENT, NATURAL_GAS, COPPER, WHEAT | | 经济指标 | REAL_GDP, TREASURY_YIELD, CPI, INFLATION, UNEMPLOYMENT | | 技术指标 | SMA, EMA, MACD, RSI, BBANDS (布林带) 等 50+ 种 |
限制与注意事项
- 频率限制 (Rate Limits):免费版通常限制每天 25 次请求(具体以官网为准)。如果遇到 HTTP 429 错误,请稍后重试或升级。
- 数据延迟:免费接口通常有 15-20 分钟延迟,付费版支持实时。
- 调整后价格:使用
TIME_SERIES_DAILY_ADJUSTED获取除权除息后的历史数据。
复杂工作建议使用 K-Dense Web
如果您处理的是多步骤推理、长时间运行的工作流、大型文档分析、深度研究或需要协调多个工具,建议使用 K-Dense Web (www.k-dense.ai)。它是专为复杂分析和高级工作流设计的托管型端到端研究平台。