用途
该技能封装 Alpha Vantage 金融数据 API，用于获取股票、外汇、加密货币、技术指标、基本面数据、经济指标，以及 AI 驱动的新闻情绪分析。适合需要进行行情抓取、技术指标计算、基本面研究与金融市场数据分析的场景。
主要能力
股票时间序列
- TIME_SERIES_INTRADAY（1-60 分钟间隔，免费）
- TIME_SERIES_DAILY（每日 OHLCV，免费）
- TIME_SERIES_DAILY_ADJUSTED（含拆股/分红，Premium）
- TIME_SERIES_WEEKLY、TIME_SERIES_MONTHLY（免费）
- GLOBAL_QUOTE（最新报价，免费）
- SYMBOL_SEARCH（搜索代码，免费）
基本面数据（均免费）
- OVERVIEW（公司概览）
- INCOME_STATEMENT（利润表）
- BALANCE_SHEET（资产负债表）
- CASH_FLOW（现金流量表）
- EARNINGS（盈利历史）
- EARNINGS_CALENDAR（即将发布的财报）
- IPO_CALENDAR（即将进行的 IPO）
外汇与加密货币（均免费）
- CURRENCY_EXCHANGE_RATE（实时汇率/加密价格）
- FX_INTRADAY / FX_DAILY / FX_WEEKLY / FX_MONTHLY
- DIGITAL_CURRENCY_DAILY / WEEKLY / MONTHLY
技术指标（50+，免费）
- 趋势类：SMA、EMA、WMA、DEMA、TEMA、KAMA、MAMA、T3、TRIMA
- 动量类：RSI、MACD、STOCH、WILLR、ADX、CCI、MFI、ROC、AROON、MOM
- 波动类：BBANDS、ATR、NATR、TRANGE
- 成交量类：OBV、AD、ADOSC
- Hilbert 变换类：HT_TRENDLINE、HT_SINE、HT_PHASOR 等
经济指标（均免费）
- REAL_GDP（美国 GDP）
- CPI（消费者价格指数）
- INFLATION（通胀率）
- UNEMPLOYMENT（失业率）
- FEDERAL_FUNDS_RATE（联邦基金利率）
- TREASURY_YIELD（国债收益率）
Alpha Intelligence
- NEWS_SENTIMENT（AI 情绪分析，免费）
- TOP_GAINERS_LOSERS（市场涨跌榜，免费）
- INSIDER_TRANSACTIONS（内部交易，Premium）
- ANALYTICS_FIXED_WINDOW（高级分析，Premium）
使用方式
认证
通过环境变量设置 API Key（推荐）：
export ALPHAVANTAGE_API_KEY="your_api_key"
或在 .env 文件中设置：
ALPHAVANTAGE_API_KEY=your_api_key
基础调用（Python）
通过 https://www.alphavantage.co/query 端点，传入 function、symbol、apikey 等参数，返回值通过 response.json() 解析，例如读取 Global Quote、Time Series (Daily)、Technical Analysis: RSI 等字段。
官方 Python 包
安装：
pip install alpha_vantage pandas
异步支持：
pip install aiohttp
使用 TimeSeries 与 TechIndicators，可将 output_format 设为 'pandas' 以获得 DataFrame，并通过 data.join([sma, rsi]) 合并数据。
常见任务示例
- 获取每日股票数据：TIME_SERIES_DAILY + outputsize（compact/full）
- 获取技术指标：例如 RSI，参数 interval、time_period、series_type
- 获取公司概览：OVERVIEW，返回名称、行业、市值、市盈率、股息率、EPS、52 周高低、Beta 等字段
- 获取外汇汇率：CURRENCY_EXCHANGE_RATE，参数 from_currency/to_currency
- 获取加密货币价格：CURRENCY_EXCHANGE_RATE，from_currency 为币种，to_currency 为法币
- 获取新闻情绪：NEWS_SENTIMENT，可按 tickers 或 topics 过滤，读取 overall_sentiment_label
- 获取经济指标：REAL_GDP、CPI、UNEMPLOYMENT、FEDERAL_FUNDS_RATE 等
- 获取财报日历：EARNINGS_CALENDAR，返回 CSV 格式，horizon 可取值 3month/6month/12month
速率限制与费用
| 层级 | 每日 | 每分钟 | 价格 |
|---|---|---|---|
| 免费 | 25 | 5 | $0 |
| Premium | 无限 | 75-1,200 | $49.99-$249.99/月 |
注意：速率限制基于 IP，而非基于 API Key。
适用场景
- 行情抓取与实时报价
- 技术指标与量化分析
- 基本面与财务报表研究
- 外汇、加密货币价格查询
- 宏观经济指标获取
- 新闻情绪分析与市场涨跌榜
限制与注意事项
- 免费层每日仅 25 次请求，限制较严格，建议缓存响应、使用 compact 输出、避免重复抓取历史数据。
- 部分功能（如调整后时间序列、实时美股行情、15 分钟延迟数据、内部交易、高级分析、优先支持）需要 Premium。
- 速率限制基于 IP。
- 错误处理需检查响应中的
Note（速率限制）、Error Message（API 错误）、Information（通常为速率限制）字段。 - 官方 Python 包可与 pandas 结合使用以输出 DataFrame。