alterlab-alpha-vantage

Alpha Vantage — 金融市場データ

20年以上にわたる世界の金融データにアクセスできます。株式、オプション、外国為替、暗号資産、コモディティ、経済指標、ファンダメンタルズ、ニュースセンチメント、50種類以上のテクニカル指標を、単一の /query エンドポイントから取得できます。

このスキルを使用する場面

• ティッカー、FX ペア、暗号資産の OHLCV 価格履歴や最新の気配値を取得する場合
• 事前計算済みの企業ファンダメンタルズ（概要比率、財務諸表、決算、配当、株式分割）を取得する場合
• サーバー側でテクニカル指標（SMA、EMA、RSI、BBANDS、...）を計算する場合
• コモディティ価格や主要な米国マクロ経済系列（GDP、CPI、利回り、失業率）を取得する場合
• イベント分析のために、ニュースセンチメント、決算説明会のトランスクリプト、インサイダー取引を取得する場合

対象外

シナリオ	代わりに使用
FRED ID（UNRATE、GDPC1）によるマクロ経済系列、サーバー側の pc1 変換、ALFRED のヴィンテージ	alterlab-fred
実際の 10-K／10-Q の項目、XBRL ファクト、SEC EDGAR の Form 4／13F 提出書類	alterlab-edgartools
1ペニー単位の財務省債務、日次／月次財務省報告書、入札結果	alterlab-usfiscaldata
ヘッジファンドのレバレッジ集計値／SEC Form PF の統計	alterlab-hedgefund-monitor
ダウンロードした系列への ARIMA／回帰モデルの適合	alterlab-statsmodels

API キーの設定（必須）

1. https://www.alphavantage.co/support/#api-key で無料のキーを取得します（プレミアムプランでは制限が緩和され、プレミアムエンドポイントが利用可能になります）
2. 環境変数として設定します：

export ALPHAVANTAGE_API_KEY="your_key_here"

Alpha Vantage の MCP コネクターが設定されている場合（Alpha Vantage は公式 MCP サーバーを運用しています。https://mcp.alphavantage.co/ を参照）、ライブデータの照会にはそちらを優先してください。以下の REST パターンはどこでも使用できます。

インストール

uv pip install requests pandas

ベース URL とリクエストパターン

すべてのリクエストは次の URL に送信します：

https://www.alphavantage.co/query?function=FUNCTION_NAME&apikey=YOUR_KEY&...params

import os
import requests

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}, timeout=30)
    response.raise_for_status()
    data = response.json()
    # Alpha Vantage reports errors and limit hits with HTTP 200 + one of these keys
    for key in ("Error Message", "Information", "Note"):
        if key in data:
            raise RuntimeError(f"Alpha Vantage {key}: {data[key]}")
    return data

クイックスタートの例

# Stock quote (latest price; end-of-day unless you have a realtime entitlement)
quote = av_get("GLOBAL_QUOTE", symbol="AAPL")
price = quote["Global Quote"]["05. price"]

# Daily OHLCV: compact = latest 100 points (free); outputsize="full" (25+ years) is premium-only
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 カテゴリ

カテゴリ	主な関数
時系列（株式）	GLOBAL_QUOTE、TIME_SERIES_INTRADAY*、TIME_SERIES_DAILY、TIME_SERIES_DAILY_ADJUSTED*、TIME_SERIES_WEEKLY(_ADJUSTED)、TIME_SERIES_MONTHLY(_ADJUSTED)、REALTIME_BULK_QUOTES*、MARKET_STATUS、SYMBOL_SEARCH
指数データ	INDEX_DATA*、INDEX_CATALOG*
オプション	REALTIME_OPTIONS*、HISTORICAL_OPTIONS*（プット・コール比率、出来高／OI 比率の各エンドポイントも含む）
Alpha Intelligence	NEWS_SENTIMENT、EARNINGS_CALL_TRANSCRIPT、TOP_GAINERS_LOSERS、INSIDER_TRANSACTIONS、INSTITUTIONAL_HOLDINGS、ANALYTICS_FIXED_WINDOW、ANALYTICS_SLIDING_WINDOW
ファンダメンタルズ	OVERVIEW、ETF_PROFILE、INCOME_STATEMENT、BALANCE_SHEET、CASH_FLOW、SHARES_OUTSTANDING、EARNINGS、EARNINGS_ESTIMATES、DIVIDENDS、SPLITS、LISTING_STATUS、EARNINGS_CALENDAR、IPO_CALENDAR
外国為替（FX）	CURRENCY_EXCHANGE_RATE、FX_INTRADAY*、FX_DAILY、FX_WEEKLY、FX_MONTHLY
暗号資産	CURRENCY_EXCHANGE_RATE、CRYPTO_INTRADAY*、DIGITAL_CURRENCY_DAILY/WEEKLY/MONTHLY
コモディティ	WTI、BRENT、NATURAL_GAS、COPPER、ALUMINUM、WHEAT、CORN、COTTON、SUGAR、COFFEE、GOLD_SILVER_SPOT、GOLD_SILVER_HISTORY、ALL_COMMODITIES
経済指標	REAL_GDP、REAL_GDP_PER_CAPITA、TREASURY_YIELD、FEDERAL_FUNDS_RATE、CPI、INFLATION、RETAIL_SALES、DURABLES、UNEMPLOYMENT、NONFARM_PAYROLL
テクニカル指標	SMA、EMA、MACD*、RSI、BBANDS、STOCH、ADX、ATR、OBV、VWAP*、その他40種類以上

* プレミアム限定（ライブドキュメントに基づく。確認日：2026-09-23）。無料関数におけるプレミアム制限付きパラメーター：TIME_SERIES_DAILY の outputsize=full、および気配値の entitlement=realtime|delayed。

共通パラメーター

パラメーター	値	備考
outputsize	compact / full	compact = 直近100件のデータポイント、full = 20年以上のデータ（TIME_SERIES_DAILY はプレミアム対象）
datatype	json / csv	デフォルト：json
interval	1min、5min、15min、30min、60min、daily、weekly、monthly	エンドポイントによって異なります
adjusted	true / false	株式分割・配当を調整します
entitlement	realtime / delayed	プレミアム対象です。過去データ／日次終値データの場合は省略します

レート制限とプラン

• 無料キー：1日25リクエスト。 シンボルをループ処理する前に呼び出しを計画してください。30銘柄のパネルでは1日の上限に達します。レスポンスをディスクにキャッシュし、再利用してください。
• プレミアムプランは、1分あたりのリクエスト数（75～1,200件）に応じて販売され、上記の星印付き関数を利用できます。
• 上限に達した場合やエラーが発生した場合、データの代わりに Information（古いレスポンスでは Note）または Error Message キーが含まれた HTTP 200 が返されます。そのため、ステータスコードではなく JSON の本文を確認してください。上記の av_get ヘルパーはこれらを検出すると例外を発生させます。

エラー処理

try:
    data = av_get("GLOBAL_QUOTE", symbol="AAPL")
except RuntimeError as err:
    # "Information" usually means the daily quota is used up or the call needs a premium key;
    # "Error Message" usually means a bad function/parameter/symbol.
    print(err)

参考ファイル

エンドポイントの詳しいドキュメントについては、次のファイルを参照してください。

• time-series.md — 株価の OHLCV データ、気配値、一括気配値、市場の状況
• fundamentals.md — 企業概要、財務諸表、決算、配当、株式分割
• options.md — リアルタイムおよび過去のオプションチェーンデータ
• intelligence.md — ニュース／センチメント、決算説明会の記録、インサイダー取引、分析
• forex-crypto.md — 外国為替レートと暗号資産価格
• commodities.md — 金、銀、石油、天然ガス、農産物コモディティ
• economic-indicators.md — GDP、CPI、金利、雇用データ
• technical-indicators.md — 50種類以上のテクニカル分析指標（SMA、EMA、MACD、RSI など）

論文やレポートで数値を使用する場合は、Alpha Vantage と取得日を明記してください。

AlterLab Academic Skills スイートの一部です。