版本
只记对调用方可见的变化——端点、字段、语义、限额。内部重构不进这里。当前规范版本 0.1.0。
| 变更 | 是否破坏性 |
|---|---|
| 删除端点或字段 | 是 |
| 改变字段类型、精度或枚举取值 | 是 |
| 收紧限额或把可选字段改成必填 | 是 |
| 新增端点、新增可选字段、放宽限额 | 否 |
| 在已有枚举里新增取值 | 否——但客户端必须容忍未知取值 |
解析响应时请忽略未知字段、容忍未知枚举值。两者都不按破坏性变更处理，写死白名单的客户端会在下一次新增时失败。
`/api/v1/px` 下的账户、持仓、订单、成交、资金流水、信用、借还出借、强平与 AI 端点此前未对外说明，现已全部收录。端点本身没有变化——变的是它们终于有了契约描述。
事件列表、详情、标签、事件下的市场详情、概率历史与 5 分钟涨跌视图。同样是补文档，不是新能力。
下单请求体的 `postOnly` 一直是**可选**的，缺省 `false`。此前的 schema 把后端的非空类型误读成了必填。行为从未改变——改的是文档。
链下引擎完整支持 FOK，但带链上签名的 FOK 单会在结算阶段 abort，而链下不会提前拦截。此前两边的分歧没有任何出处。签名单请用 GTC 或 GTD。
4xx / 5xx 的示例体此前没有，现按真实网关响应补齐：`auth_required` 的 `recoverable` 是 `true`、`market_not_found` 是 `false`，链上绑定端点的错误体是 `{error, status}` 而非统一错误体。
规范原文可下载：总览页 顶部有 OpenAPI (YAML)。这份文档由该规范生成，不是手抄——规范与页面不一致会被构建期的漂移闸拦下。
