面向开发者的 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 % 起)。