参考

更新日志

API 契约的变更，按时间从新到旧排列，以及我们在破坏性变更前承诺的通知期。当前契约：v1，OpenAPI 版本 1.1.0。

#版本与弃用

契约版本为 v1。以下变更不具破坏性，发布时不另行通知：新增接口、响应中新增字段、新增可选参数、新增 error.code、说明性文本中出现新值。请编写能忽略未知字段的客户端。

破坏性变更：删除或重命名接口、字段、参数或 error.code，更改单位或字段含义。破坏性变更会在本页公布，并且只有在通知期届满后才会对你的方案生效：

所有错误只有一种结构：status: "error"、timestamp、error {code, message, param} 和 detail。error.code 稳定且可供机器读取，请据此进行分支处理。detail 予以保留，并重复错误消息；对于校验错误，它现在是字符串而不是列表。
错误消息改为英文（此前为法文）。依据法文文本进行匹配的客户端必须改用 error.code。
/v1/snapshot 接受 =true 作为深度 1（funding_rate_8h=true）。仅传入 symbol 调用时，现在还会返回 available_multi_tf_fields、timeframes 和 max_depth。
比特币历史接口支持 timePeriod=1mo，这是“一个月”的无歧义写法；1m 在这些接口上仍然有效，且仍表示一个月。
POST /v1/indicators 也接受嵌套在 parameters 对象中的参数。
在稳定币上调用 /v1/trades/future 会返回 unavailable: "not_applicable"（此前为 no_data）。
客户端提出请求时，响应会被压缩（gzip）；GET https://api.bytnode.com/ 返回一个 JSON 格式的链接索引。
OpenAPI 契约现在包含 schema、每个字段的单位、每个接口的真实示例、错误响应和代码示例。新增：llms-full.txt、Postman 集合和交互式参考。
/v1/macro/correlations（method）和 /v1/macro/risk（condition）的文本改为英文。

data 下每个带时间戳的对象还带有 time，它是 bucket、timestamp、date… 的副本，因此通用客户端只需读取一个键。
每个 data 为空的 REST 接口都带有 unavailable（not_applicable、no_api_key、no_data），与快照一致。
附带每个数值字段单位的 OpenAPI 契约在 /openapi.json 免密钥提供。
OHLC K 线来自每个交易对的一个参考现货市场；成交量仍为跨交易所聚合。
未知的 timeframe 返回 422，不再是 403。

严格参数：接口未声明的参数或重复的参数会返回 422 并附带建议（此前会被悄悄忽略）。
以秒、微秒或纳秒表示，或早于 2009-01-03 的 since_ms / until_ms 会返回 422。
按后缀区分单位：*_pct 为百分比，*_ratio 为比例（小数），*_bps 为基点。apr 更名为 apr_pct；basis_pct 以 ×100 提供。
所有时间戳均为带固定毫秒的 ISO 8601 UTC 格式（2026-09-28T14:00:00.000Z）。
响应包装会重复请求实际生效的 symbol 和 timeframe。
is_closed 不可变：已收盘的区间是最终值，绝不会被改写。
IETF 格式的速率限制响应头（RateLimit-Policy、RateLimit），包含剩余的月度配额。
在边缘层产生的所有错误都是 JSON，绝不是 HTML 页面。
/v1/status 中每个公开数据源占一行，阈值为其预期间隔的 1.5 倍。