ECB参照レートの解説

/v1/latest/USDを呼び出してsource: ecb_dailyが返ってきたとき、それは欧州中央銀行のユーロ外国為替参照レートを読んでいる — CET16:00頃に営業日ごとに1回公表され、参照および情報提供を目的としており、取引には使えない。これはEURペアにとって最も権威ある日次のFX数値だが、あくまで1回のスナップショットであり、市場はCET16:00以降も動き続け、フィックスは翌営業日まで更新されない。

ECB参照レートとは何か

欧州中央銀行は営業日ごとに、ユーロ外国為替参照レートの一式を公表している。これらはCET16:00頃、欧州中央銀行制度の内外の中央銀行との協議プロセスを通じて算出される。レートはその時点でのコンセンサス・ミッドマーケット値を表しており、ECB自身の文書が明記するとおり、情報提供および参照目的のみに用いることを意図している。

これらは公的機関に由来し、固定された透明なスケジュールで公表されるため、EU域内の金融契約、会計、規制報告で広く使われている。APIレスポンスでsource: ecb_dailyを見たとき、まさにこれを読んでいることになる。

APIにおける3つのソースクラス

APIのすべてのレスポンスには、そのレートがどのデータクラスに由来するかを示すsourceフィールドが含まれる。3種類ある：

3つ目のクラスであるfred_dailyは米連邦準備制度の日次系列に由来し、連邦準備制度が独自の参照値を公表しているUSDペアで最も重要になる。ecb_dailyと似た頻度で、営業日ごとに1回、米国の祝日には欠落がある。

ECB由来のレスポンスを読む

任意のベース通貨で最新レートをリクエストし、sourceを確認すれば何を見ているかがわかる：

curl -s https://api.exchangerate.dev/v1/latest/EUR

{
  "result": "success",
  "base": "EUR",
  "source": "ecb_daily",
  "market_session": "open",
  "timestamp": "2026-06-19T14:05:33Z",
  "data_updated_at": "2026-06-19T14:00:00Z",
  "rates": {
    "USD": 1.14235,
    "GBP": 0.86781,
    "JPY": 184.320
  },
  "notice": "Indicative rates, not for settlement. Source: incl. ECB statistics."
}

すべてのレスポンスに2つのタイムスタンプフィールドが現れる。data_updated_atは元のレートがデータストアに最後に書き込まれた時刻だ。ecb_dailyの場合、直近の営業日のCET16:00頃になる。timestampはAPIがレスポンスを構築した時刻だ。レスポンスをキャッシュするなら、鮮度を追跡すべきフィールドはdata_updated_atだ。

この最初のリクエストはキーなしで動く。スケジュールされたジョブやアプリケーションで呼び出すようになったら、無料キーを作成してアカウント単位のクォータを得て、サーバー側に保管する。

フィックス間、週末、フォワードフィル

ECBフィックスは1日1回のスナップショットだ。CET16:00頃の公表から翌営業日のフィックスまでの間、ecb_dailyのデータは更新されない — 日中や夜間の市場変動は反映されない。ECBは週末や祝日にも公表しないため、土曜日や日曜日のリクエストには金曜日のフィックスが返る。APIはis_forward_filledフィールドで非公表日を扱う：

curl -s https://api.exchangerate.dev/v1/2026-06-13/USD \
  -H "Authorization: Bearer exr_live_..."

{
  "result": "success",
  "base": "USD",
  "source": "fred_daily",
  "market_session": "weekend",
  "is_forward_filled": true,
  "rates": {
    "EUR": 0.87531,
    "GBP": 0.75945,
    "JPY": 161.412
  }
}

is_forward_filledがtrueのとき、レスポンス中のレートは直前の営業日から持ち越された最後の公表値だ。新しい観測値ではない。多くの用途（週末にレートを表示する、チャートを埋めるなど）ではこれで問題ない。会計や監査証跡のように、特定の日に実際にフィックスが存在したかを記録する必要がある場合は、このフラグを確認すべきだ。

Pythonでsourceを確認する

レートを読み取り、sourceによって表示方法を分岐させるのはよくあるパターンだ：

import requests

API = "https://api.exchangerate.dev/v1"
KEY = "exr_live_..."

resp = requests.get(
    f"{API}/latest/USD",
    headers={"Authorization": f"Bearer {KEY}"},
    timeout=10,
)
resp.raise_for_status()
data = resp.json()

rate = data["rates"]["EUR"]        # 0.87531
source = data["source"]            # ecb_daily
session = data["market_session"]   # open

if source == "ecb_daily":
    print(f"ECB reference rate as of last business day: {rate}")
elif source == "live":
    print(f"Indicative spot rate ({session}): {rate}")
else:
    print(f"Rate ({source}): {rate}")

1999年までの履歴

ECBはユーロ導入時にEXRシリーズを開始した。APIは日付指定エンドポイント/v1/{date}/{base}とレンジエンドポイント/v1/rangeを通じてこの全履歴を公開している。どちらも該当箇所にはis_forward_filledを返す。任意の期間について、特定の通貨ペアの時系列を取得できる：

curl -s "https://api.exchangerate.dev/v1/range?base=EUR&symbols=USD&start_date=2026-06-10&end_date=2026-06-16" \
  -H "Authorization: Bearer exr_live_..."

パラメータ名に注意：start_dateとend_date（スネークケース）、symbolsはカンマ区切りの文字列だ。レンジは公表された営業日ごとに1行を返し、各行に固有のsourceとis_forward_filledが付く。週末の日付は行として含まれない。