文档 /

历史汇率

单日数据使用日期路径，日序列使用 `/v1/range`。已发布数据从 1999-01-04 开始。

请求一个日期

如果日期落在周末或休市日，接口会返回最近发布的定盘值，并把 `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 游标。

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