晰联 CELRYN · 通信数据，清晰可循

GET/v1/exchange-rates

用途与边界

采用 CFETS 受权公布的人民币汇率中间价机制，不称为“中午 12 点汇率”。报价日期、抓取时间分别保留。没有同日 USD 基准时美元值为 null；无可得报价或明确工作日缺数据返回 503 EXCHANGE_RATE_UNAVAILABLE，不补造价格。周末沿用不改写 date；没有供应方交易日历时不猜测法定节假日。

请求参数

参数	类型 / 位置	说明
`currency`	string · 选填	ISO 币种代码，例如 JPY。
`country`	string · 选填	地区代码或名称。
`date`	YYYY-MM-DD · 选填	省略时返回筛选范围内最新可得报价；周末可沿用最近报价，date 始终为实际报价日期。明确工作日缺数据返回 503。

请求示例

cURL / 合成示例

curl 'https://YOUR_CELRYN_HOST/api/v1/exchange-rates?currency=JPY&date=2026-09-08' \
  -H "X-API-Key: $CELRYN_API_KEY"

成功响应示例

以下是结构示例，不是当前在线目录的查询结果。

JSON

{
  "code": 0,
  "data": [],
  "meta": {
    "request_id": "example-request-id",
    "dataset_version": "example-v1",
    "source_mode": "demo",
    "source_published_at": null,
    "ingested_at": "2026-09-08T00:00:00Z"
  }
}

data 字段语义

字段	类型	说明
`currency / date / unit`	string / string / number	币种、报价日期与报价单位，可能是 100 JPY。
`cny_per_unit`	number	每 unit 个该币种对应的 CNY 数量，方向为该币种 → CNY。
`usd_per_unit`	number \| null	每 unit 个该币种对应的 USD 数量。
`usd_derived`	boolean	同日交叉计算为 true，不是官方直报价。
`source / fetched_at / source_mode`	string / string / enum	来源、实际抓取时间与演示/参考等模式。

响应、鉴权与错误

数据接口支持X-API-Key 或同源 Cookie 会话。匿名访问为受限公共投影，完整字段权限由 API 服务执行。JSON 成功响应统一为{code:0,data,meta}；文件导出直接返回文件。

字段	说明
`meta.request_id`	本次请求标识，用于排查错误，不包含密钥。
`meta.dataset_version / source_mode`	当前数据版本与 demo / ir21 / reference / mixed 来源模式。
`meta.source_published_at`	源发布时间；未知为 null。
`meta.ingested_at`	平台导入时间，ISO 格式 UTC。

400 表示参数不符，401 表示需要有效凭证，403 表示权限不足，429 表示调用限制，503 表示服务或数据源暂不可用。请读取错误响应的 code、message、request_id，详见错误与重试。

ERROR / 示意结构

{
  "code": "EXAMPLE_ERROR_CODE",
  "message": "具体错误原因由服务端返回",
  "request_id": "example-request-id"
}