alpha-vantage

Alpha Vantage — 金融データ API

⚠️ 重要：無料の API Key が必要です。「認証」セクションをご覧ください。

世界中をカバーする金融データ API（20 以上の取引所、200,000 以上のティッカー）。

ベース URL: https://www.alphavantage.co/query
完全なドキュメント: alphavantage.co/documentation

---

認証

API Key を取得する（無料）

1. https://www.alphavantage.co/support/#api-key にアクセスします
2. フォームに入力します（メールアドレス、名前、利用目的）
3. メールで API Key がすぐに届きます
4. クレジットカードは不要です

API Key を使用する

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

⚠️ 共有またはコミットするコードに API Key をハードコードしないでください。

---

レート制限

プラン	リクエスト数／日	リクエスト数／分	価格
Free	25	5	$0
Standard	∞	75	$49.99/月
Premium	∞	150	$99.99/月
Enterprise	∞	1,200	$249.99/月

Free Tier の推奨事項

• レスポンスをキャッシュする — データは頻繁には変わりません
• 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."
}

---

利用可能なエンドポイント

Time Series — 株式（Free Tier）

Function	説明	備考
TIME_SERIES_DAILY	日次 OHLCV	⚠️ compact のみ（100 件）
TIME_SERIES_WEEKLY	週次 OHLCV	全期間の履歴
TIME_SERIES_MONTHLY	月次 OHLCV	全期間の履歴
GLOBAL_QUOTE	最新価格のクオート	高速
SYMBOL_SEARCH	シンボルを検索

Time Series — PREMIUM

Function	説明
TIME_SERIES_INTRADAY	日中データ（1／5／15／30／60 分）
TIME_SERIES_DAILY_ADJUSTED	株式分割・配当調整済み
outputsize=full	全期間の履歴（20 年以上）

ファンダメンタルデータ（Free Tier）

Function	説明
OVERVIEW	企業概要
INCOME_STATEMENT	損益計算書
BALANCE_SHEET	貸借対照表
CASH_FLOW	キャッシュフロー
EARNINGS	過去の収益

Forex（Free Tier）

Function	説明
CURRENCY_EXCHANGE_RATE	現在の為替レート
FX_INTRADAY	日中の外国為替データ
FX_DAILY	日次の外国為替データ
FX_WEEKLY	週次の外国為替データ
FX_MONTHLY	月次の外国為替データ

Cryptocurrency（Free Tier）

Function	説明
CURRENCY_EXCHANGE_RATE	暗号資産と法定通貨の為替レート
DIGITAL_CURRENCY_DAILY	日次の暗号資産データ
DIGITAL_CURRENCY_WEEKLY	週次の暗号資産データ
DIGITAL_CURRENCY_MONTHLY	月次の暗号資産データ

テクニカル指標（Free Tier で 50 種類以上）

完全な一覧は ./references/indicators.md をご覧ください：

カテゴリ	指標
トレンド	SMA, EMA, WMA, DEMA, TEMA, KAMA など
モメンタム	RSI, MACD, STOCH, WILLR, ADX, CCI など
ボラティリティ	BBANDS, ATR, NATR, TRANGE
出来高	OBV, AD, ADOSC

経済指標（Free Tier）

Function	説明
REAL_GDP	米国の GDP
CPI	消費者物価指数
INFLATION	インフレ率
UNEMPLOYMENT	失業率
FEDERAL_FUNDS_RATE	フェデラルファンド金利
TREASURY_YIELD	米国債利回り

Alpha Intelligence（Free Tier）

Function	説明	備考
NEWS_SENTIMENT	センチメント分析	Free
TOP_GAINERS_LOSERS	値上がり・値下がり上位	Free
INSIDER_TRANSACTIONS	インサイダー取引	⚠️ PREMIUM
ANALYTICS_FIXED_WINDOW	高度な分析	⚠️ PREMIUM

---

使用例

現在のクオート（最も簡単）

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

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
}

Forex

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 requests per minute"	レート制限	12秒以上待つ
"25 requests per day"	1日の上限	24時間待つか、アップグレードする
"Invalid API call"	シンボルが存在しない	まず SYMBOL_SEARCH を使用する
response に "premium"	プレミアムエンドポイント	無料の代替手段を使用するか、アップグレードする