变更日志

接口、计费与数据结构改了什么

Agent 最怕的是"行为悄悄变了"。这里按时间倒序记录每一次对外可见的变更； 破坏性变更会标 BREAKING，并给出迁移方式。 机读版本：/changelog.json

2026-11-05

计费安全修复 + 端点收敛 + 限流上线

  • 链上交易去重：新增 used_tx 表，一笔 USDC 转账只能兑换一次交付；交付失败会释放，允许重试。重复提交返回 402 tx_already_used。
  • 积分扣费按次生效：以前同一 IP 对同一工具只扣一次（幂等键设计错误），现已改为每次调用独立计费；网络重试请带 Idempotency-Key 头保持幂等。
  • 免费额度不再被失败请求消耗：只有成功交付才计入 free_per_day。
  • 产品 MCP 端点上线：/mcp/gpu-market、/mcp/rwa-intel 直连可用。此前文档里的 api.feegate.org 域名并不存在，已全部改为主域路径。
  • 免费数据 API 加限流：每 IP 每天 2,000 次，返回 X-RateLimit-*；深翻页上限 offset=10000，超限会明确告知而不是静默截断。
  • MCP 工具参数改为真实 schema：不再需要把参数塞进 params_json 字符串，缺少必填参数会在调用前报错。
  • 全站安全头恢复：HSTS、CSP、Permissions-Policy 重新生效，并修掉了 location 级 add_header 覆盖上级安全头的隐患。
  • 新增 /status/ 可用性页、/catalog.json、/openapi.json、/.well-known/security.txt。
2026-11-04

GEO 与引用层

  • 新增 /cite/ 与 /cite.json：单一权威口径，每个数字带 as_of 与来源文件。
  • 多语言免费区（ja / ko / ar）上线，五语种互相 hreflang。
  • sitemap 扩到 172 条，接入 IndexNow 逐条推送。
2026-11-02

免费区与免费工具台

  • 免费区上线 6 个公开数据集（x402 资源索引、MCP 服务器目录、DeFi TVL、现货行情、x402 生态清单、AI 可读性普查），每条带 source_url 与 content_hash。
  • 免费数据 API 与免费 MCP 端点上线（无 Key、无付款）。
  • 工具台上线 21 个免费工具。
2026-10-31

结算口径

  • 结算改为按自然日归集（UTC+8）、次日 12:00 出账；取消原「次月 10 日月结」。
  • 不设起结门槛，当期有多少结多少；对账只认链上 Transfer 事件。

订阅方式：/llms.txt 与 /changelog.json 都可以定时拉取比对； 需要变更通知邮件，写信到 brian@51kaifa.app。