文件 /

歷史匯率

一日資料用日期 path，每日序列用 `/v1/range`。公開資料由 1999-01-04 開始。

請求一個日期

如果係週末或者休市日，endpoint 會返回最近發布嘅 fixing，並將 `is_forward_filled` 設為 true，唔會作出一個新觀測值。

bash · one date
curl "https://api.exchangerate.dev/v1/2024-01-15/EUR?symbols=USD,GBP"

請求一段日期

填 `symbols`、`start_date` 同 `end_date`。JSON 每頁最多 366 行；`has_more` 係 true 就將 `next_cursor` 傳去下一次請求。

bash · date range
curl "https://api.exchangerate.dev/v1/range?base=USD&symbols=EUR,GBP&start_date=2024-01-01&end_date=2024-06-30"

下載 CSV 或 Parquet

加 `format=csv` 或 `format=parquet`。下載檔案包含整段日期，唔使用 JSON cursor。

bash · CSV
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"   --output usd-rates-2024.csv

將來源資料同數值一齊保存

保留 `source`、`is_forward_filled` 同 `derived_symbols`，之後先解釋到每條數據。

source · is_forward_filled · derived_symbols