菜单

历史汇率

日期路径或`/v1/range`:Plus/Pro自1999-01-04起;Basic 1年;Free及免密钥30天。

请求一个日期

如果日期落在周末或休市日,接口会返回最近发布的定盘值,并把 is_forward_filled 设为 true,不会编造观测值。

bash · Plus / Pro
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 每页最多 366 行;has_more 为 true 时,把 next_cursor 传入下一次请求。

bash · Plus / Pro
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。下载文件包含整个请求区间,不使用 JSON 游标。

bash · Plus / Pro · 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" \  -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 个唯一货币对:143 个 USD 货币对及 78 个交叉盘。

历史交叉盘要求真实收盘观测位于同一 UTC 区间内,时间差不超过 5 秒。effective_at 使用较早的观测时间。不填补缺口;尚未结束的区间可能变化。1d 使用全目录的日参考数据。表中每个货币对只计一次,支持双向。

interval唯一货币对
1m221
5m221
15m221
1h221
4h209
1d10296
curl · Pro · EUR/JPY · 15m
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)。混合请求会整体拒绝。

覆盖范围与限制详情

日内汇率 API