exchangerate.dev1. 取得元の分類
公開フィールドsourceは、データ提供会社ではなくデータの分類を示します。liveは、銀行間取引が行われる週の間、短い間隔で更新されることがある参考用の直物市場データです。ecb_dailyは欧州中央銀行の参照レートで、通常は営業日ごとに1回公表されます。market_dailyは、ECBの参照レートが設定されない通貨について、市場データフィードの日次終値を保存します。
複数通貨のレスポンスには、レートを提示する各通貨のsourcesマップが含まれます。最上位のsourceは保守的に判定され、そのレスポンスに含まれる中で最も鮮度の低い分類を示します。
参照：ECBのユーロ参照為替レート。
2. 時刻と市場の状態
data_updated_atは、元となる観測データが最後に書き込まれた時刻です。timestampは、APIレスポンスが生成された時刻です。データの経過時間の計算には前者を、リクエスト時刻の監査には後者を使用してください。
market_sessionは、銀行間取引が行われる週の間はopen、ニューヨーク時間の金曜日17:00の取引終了後から日曜日17:00まではweekend、週末以外の既知の休場時はinterbank_closedになります。週末のレスポンスには、その取引週の最後の観測データが含まれる場合があります。このラベルは、週末に新しいレートが提示されたことを意味しません。
3. 基準通貨の変更とクロスレートの導出
レートは正規化されており、呼び出し側は対応する任意の基準通貨を指定できます。通貨ペアを直接観測していない場合、APIは利用可能な構成ペアを介して三角計算を行います。導出された値はderived_symbolsで識別されます。単一ペアのレスポンスでは、該当する場合にderivedと上限値derivation_bps_maxも公開されます。
クロスレートは、構成するペアの中で最も鮮度の低い取得元を引き継ぎます。導出レートを受け入れられないアプリケーションは、通貨ペアから推測せず、導出に関するフィールドを確認してください。
4. 過去の観測データ
日次履歴には、公表された参照レートと市場終値を組み合わせています。主要通貨のデータは1999年までさかのぼります。約30通貨はECBの参照レートを、残り113通貨は市場終値を使用し、データの開始日は通貨ペアによって異なります。週末や祝日で新しい参照レートが公表されない場合、過去の観測データを繰り越すことがあり、is_forward_filled: trueと表示されます。APIは未公表の参照レートを作成しません。
5. 検証と公表
- 通貨識別子は、レート算出前にISO形式の大文字コードに正規化されます。
- 取得元と更新時刻のフィールドは、クライアントが推測するのではなく、観測データに付随します。
- ライブの観測データが存在しない場合や古すぎる場合は、ライブと表示せず、利用可能な日次参照データの分類に切り替えます。
- すべてのプランで同じ取得元を使用します。Freeとキーなしの呼び出しでは、ライブレートを15分遅延で受け取ります。
- 公表する調査には、測定期間、サンプル数、方法、制限事項を含める必要があります。
6. 制限事項
これらは参考用の参照レートであり、取引を実行できる買値・売値ではありません。銀行、カード会社、ブローカー、決済サービス提供会社、現金両替業者のスプレッドや手数料は含まれていません。清算、支払いの実行、規制対象の取引、正式な記録の情報源として使用してはいけません。対応範囲とデータの鮮度は、通貨、取得元の利用可能性、市場の休場、参照機関の公表スケジュールによって異なる場合があります。
7. データ鮮度ベンチマークの基準
ランキングの公表前にプロトコルを公開します。再現可能な為替APIデータ鮮度ベンチマークでは、観測期間、タイムスタンプの要件、指標、除外条件、最小サンプル数を定義しています。機械可読プロトコルには、現在、提供会社の結果は含まれていません。明示した証拠の基準を満たした後にのみ、結果を追加します。
改訂履歴
1.1 · 2026年10月9日： Freeの遅延と市場の日次終値を明確化。
1.0 · 2026年7月16日： 公開算出方法の初版、取得元の意味、市場セッションのルール、導出方針、過去データの扱い、制限事項、ベンチマークの公表基準。