参考

面向开发者的 API 更新日志

API 契约中值得关注的部分变更,按时间从新到旧排列;并非完整列表。当前契约:v1,OpenAPI 版本 1.0.2。

#版本

路径为 /v1;契约本身以 info.version 编号(语义化版本,见“版本”页面)。以下变更不具破坏性,发布时不另行通知:新增接口、响应中新增字段、新增可选参数、新增 error.code、说明性文本中出现新值。请编写能忽略未知字段的客户端。

破坏性变更:删除或重命名路由、字段、参数或 error.code,更改单位或字段含义。破坏性变更随契约的一个新主版本生效,即该版本发布当天:info.version 表明当前使用的版本。MCP 服务器有自己的版本(serverInfo.version,以及每个响应中的 mcp_version),遵循同样的规则。

#变更

可用任意订阅阅读器关注本日志:/changelog.xml(RSS,英文)。

2026-11-13 · MCP 1.1.0:<code>context</code>,每个值都放回其自身历史中

  • MCP 服务器新增:context 为每个序列给出其最新值在自身近期历史中的位置:百分位(0-100)、z 分数、参与比较的点数和时间窗口。
  • 在 get_pair_brief 中始终提供;在 get_pair_data、get_options_data 和 get_market_overview 中通过 context=true 提供。
  • 参考历史由服务器读取:所有套餐使用相同窗口,不计配额。
  • 每个消耗配额的工具新增 dry_run 和 max_quota_cost:智能体可在调用前查看其成本,并拒绝超出预算的调用。
  • 仅为新增:不读取 context 的客户端不受任何影响。
  • 文档更正:get_pair_brief 每个交易对消耗两个配额请求,另加一个(此前文档写的是每个交易对约一个)。

2026-11-07 · 合约 1.0.0,新的起点

  • 合约从 1.0.0 版本重新开始:之前的版本及其存档已撤下。此后每个新版本都存档于 /openapi/1.0.0.json 等地址,并列于 /openapi/index.json。
  • 不兼容变更:/v1/eth/gas 和 /v1/eth/gas/history 不再返回 safe_gas_price_gwei、propose_gas_price_gwei 和 fast_gas_price_gwei。请使用 base_fee_gwei 和 gas_used_ratio。
  • 以太坊历史更长:总供应量和市值自 2015-07-30 起,ETH 销毁量、通缩和 gas 自 London 升级(2021-08-05)起。2026-06-08 至 2026-09-02 期间因上一数据源错误而失真的供应量已更正。较早的日期中,供应量明细(execution_issuance_cumulative、consensus_rewards_cumulative、burnt_fees_cumulative、withdrawn_cumulative)可能为 null;total_supply 始终有值。
  • /v1/btc/active-addresses、/v1/btc/nvt 和 /v1/btc/revenue-per-difficulty 现直接根据比特币区块计算,历史数据自 2013 年起;自 10 月 29 日起因上一数据源故障而冻结的数值已被替换。
  • nvt_signal 采用原始定义:当日市值除以链上交易量(美元)的 90 日均值。其 label 与自身最近 730 天比较:undervalued(低于 25 %)、fair(自 25 % 起)、overvalued(自 75 % 起)、bubble(自 95 % 起)。