更新日志
Data API 及其契约的每一项变更，最新在前。版本号遵循版本与弃用政策。
/mcp 现在也接受以 X-API-Key: YOUR_API_KEY 请求头发送的 MCP 密钥，适用于将 Authorization 专用于自身登录的客户端和网关（例如 Smithery）。Authorization: Bearer 继续可用，也依旧是文档中的默认方式；同时发送两个请求头时，验证的是 X-API-Key 中的密钥。位于 /api/v1 的 Data API 仍然只接受 Bearer 密钥。身份验证失败现在除了按 IP 限流，还会按密钥限流，因此一个客户端的无效密钥不会再连带锁定共用同一 IP 的其他客户端。
GET /calculators/compound-interest 过去会把期限四舍五入为整数个复利期，因此在复利期中途结束的期限会被模拟得过长或过短：按 annually 复利的 6 个月会按整整一年计算（12 次定投和一整年的利息），而 5 个月则一个复利期都不计算（没有定投，也没有利息）。现在整数个复利期照旧计算，最后不足一期的部分按比例计息（该部分按单利计算），期限内的每一笔定投都会计入。期限恰为整数个复利期时结果不变；参数和响应字段均不变。
API 及其文档曾将 rate 视为每个复利周期的利率，而网站计算器及其使用指南采用的是年利率。GET /calculators/compound-interest 过去会把 rate 全额应用到每个复利周期，因此按月复利的 5% 实际按每月 5% 增长。现在 rate 为名义年利率：每个周期的利率为 rate 除以每年的周期数（年利率 5% 按月复利，即每月 5/12%），meta.note 现已注明这一点。参数和响应字段均未改变；除 annually 外，所有复利频率的结果都会变化。此外，当 contribution_frequency 和 compound_frequency 同为 daily 或同为 weekly 时，存入不再因浮点数舍入误差而延后或遗漏，因此在 duration_unit=months 下，total_contributions 可能多出一笔存入金额。这改变了现有参数的含义：如需重现之前的结果，请将 rate 乘以每年的复利期数。
每个 Fear & Greed 读数现在都在 score 旁包含 index：即与 Bitculator 显示完全一致的 0–100 Fear & Greed 指数（0–19 极度恐惧，20–39 恐惧，40–59 中性，60–79 贪婪，80–100 极度贪婪）——显示时请使用它。score 保持不变：它是推导出 index 的原始 −100…+100 综合值。适用于 GET /sentiment/fear-greed（主读数及 intervals 中的每一项）、GET /global 中的 fear_greed 以及 GET /global/heatmap 中的 meta.fear_greed。仅为新增，未修改任何现有字段。
GET /coins/{slug} 对没有最大供应量的币种（例如供应量无上限的 Solana 和 Ethereum）将 fully_diluted_valuation 返回为 0。现在改为回退到总供应量，两者均未知时为 null，与 OpenAPI 合约此前的说明一致。
没有流通供应量的币种，其 marketcap 和 dominance 可能为 null；未排名的交易所，其信任评分的 score 和 breakdown 为 null。当币种在所选指标上没有当前值时，POST /alarms 返回 422。/coins/recently-added 和 /wallets/timeline 现在遵循 sort。/coins/gainers 和 /coins/losers 按涨跌幅本身排序（此前实际上按市值排序），且 losers 排除涨跌幅为 0.00 的币种。升序排序会将 null 值排在最后。/prices 会将有歧义的代码解析为排名最高的活跃币种。OpenAPI 契约会标注可能为 null 的市场字段，并将 24 小时交易量定义为数字类型。
已发布的契约现在包含媒体类型级别的示例、一个由所有 4xx/5xx 响应共同引用的错误 schema、每个带密钥调用都可能返回的 401、429 与 500 响应、每个成功响应上的 X-RateLimit-* 与 X-Quota-* 响应头、作为 POST /webhooks 回调的 alarm.triggered 投递，以及联系方式、许可证与条款元数据。没有任何请求或响应发生变化 - 变的只是描述方式。
新增：/apis.json、/.well-known/api-catalog（RFC 9727）、/.well-known/security.txt（RFC 9116）、共享响应结构的 JSON Schema 包、附带 JSON 版本的公开状态页、本更新日志，以及版本与弃用政策。
MCP 服务器已迁移到自己的密钥与套餐，在 MCP 控制台中创建。/mcp 不再接受 Data API 密钥；每次工具调用仍然计为一次请求。
Bitculator MCP 服务器已在 /mcp 上线：通过 Streamable HTTP 向 Claude、Cursor、VS Code 及任何 MCP 客户端提供 19 个只读工具，返回与 REST API 相同的十进制字符串数据。
TypeScript、Python、PHP、Go、Rust、Java、C# 与 C++ 客户端，每一个都覆盖全部端点并共享同一传输核心：Bearer 认证、信封解包、X-Quota-* 捕获、429 与 5xx 重试、类型化错误与分页。
部分端点与较长的指标窗口现在需要 Starter 或 Pro 套餐。超出你套餐范围的调用会返回 403 plan_required，并在 details.required_plan 中指明可解锁它的套餐，且不消耗配额。
正式上线：15 个分组共 85 个操作 - 币种、价格、市场、交易所、钱包、全局、市场情绪、指标、清算、换算、计算器、编辑内容、警报、Webhook 与元信息。具备 data-api 权限的 Bearer 密钥、{ data, meta } 信封、十进制字符串精度、X-Quota-* 响应头、带签名的 Webhook，以及各自拥有月度配额的 Free、Starter 与 Pro 套餐。
弃用会在此处公布，并在移除前至少六个月通过邮件通知每一位密钥所有者 - 参见弃用政策。机器可读索引 /apis.json 以最新条目的日期作为其 modified 时间戳。