exchangerate.dev1日分を取得する
週末や休場日は直前の公開フィキシングを返し、is_forward_filledがtrueになります。架空の値は作りません。
過去の為替レートを画面で確認する 場合は、履歴検索ツールを使うと日付と通貨を選んで結果を確認できます。表示したリクエストはそのままAPIで利用できます。
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP" \ -H "Authorization: Bearer YOUR_API_KEY"期間を取得する
symbols、start_date、end_dateを指定します。JSONは1ページ最大366行で、has_moreがtrueならnext_cursorを次のリクエストへ渡します。
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30" \ -H "Authorization: Bearer YOUR_API_KEY"CSVまたはParquetをダウンロードする
format=csvまたはformat=parquetを追加します。指定期間全体が1ファイルになり、JSONカーソルは使いません。
curl -L "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-12-31&format=csv" \ -H "Authorization: Bearer YOUR_API_KEY" \ --output usd-rates-2024.csv来歴を数値と一緒に保存する
source、is_forward_filled、derived_symbolsを残すと、後から値の由来を説明できます。
source, is_forward_filled, derived_symbols
イントラデイ系列と対象通貨
/v1/timeseries は1m、5m、15m、1h、4hと日次参照値1dに対応します。2hはありません。USDを含まないSGDクロスは4hの対象外ですが、USD/SGDと逆方向は対象です。市場データの収集開始日は2026-09-14です。1mは30日間保持し、それより大きい間隔には定期的な削除期限がありません。保持期間と実際に蓄積した履歴の長さは異なります。 1mから1hのイントラデイ対応範囲は221のユニークペアで、USDペア143組とクロス78組です。
履歴クロスは同じUTC区間にある実際の終値観測を使い、時刻差は最大5秒です。effective_atは古い方の観測時刻です。欠損は補完せず、進行中の区間は変わる場合があります。1dは全カタログの日次参照値です。表は通貨ペアを重複せず数え、両方向に対応します。
| interval | 通貨ペア数 |
|---|---|
1m | 221 |
5m | 221 |
15m | 221 |
1h | 221 |
4h | 209 |
1d | 10296 |
curl "https://api.exchangerate.dev/v1/timeseries?base=EUR&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T13:00:00Z" \ -H "Authorization: Bearer YOUR_API_KEY"対象期間に観測がない場合はHTTP 200でdata: []、has_more: false、next_cursor: nullを返します。不明な間隔はunsupported_interval、対象外ペアはunsupported_pair_intervalとrejected_pairsを返します（HTTP 400）。対象外を含むリクエストは全体を拒否します。