请求一个日期
如果日期落在周末或休市日,接口会返回最近发布的定盘值,并把 `is_forward_filled` 设为 true,不会编造观测值。
请求一段日期
填写 `symbols`、`start_date` 和 `end_date`。JSON 每页最多 366 行;`has_more` 为 true 时,把 `next_cursor` 传入下一次请求。
下载 CSV 或 Parquet
添加 `format=csv` 或 `format=parquet`。下载文件包含整个请求区间,不使用 JSON 游标。
把来源信息与数值一起保存
保留 `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 天,更大间隔没有计划到期删除。保留期限不代表已经积累了同样长度的历史。
历史交叉盘要求真实收盘观测位于同一 UTC 区间内,时间差不超过 5 秒。effective_at 使用较早的观测时间。不填补缺口;尚未结束的区间可能变化。1d 使用全目录的日参考数据。表中每个货币对只计一次,支持双向。
| interval | 唯一货币对 |
|---|---|
1m | 91 |
5m | 91 |
15m | 91 |
1h | 91 |
4h | 79 |
1d | 465 |
支持的时间窗口没有观测时返回 HTTP 200,包含 data: []、has_more: false 和 next_cursor: null。未知间隔返回 unsupported_interval;范围外货币对返回 unsupported_pair_interval 和 rejected_pairs(HTTP 400)。混合请求会整体拒绝。
AUD, CAD, CHF, EUR, GBP, JPY, MXN, NOK, NZD, PLN, SEK, SGD, USD, ZAR