CoinAnk清算历史怎么核？辨对象、单位和错误返回
链小知 · 进阶 · 核验 · 依官方文档整理
从官方发布的静态规范核交易对及汇总历史，保留规范不足与样例矛盾。
开始前准备
- 仅核公开文档或自己已有的脱敏材料；不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项，错误不记成零。
1. 核入口与API权限
当前官方发布HTML内嵌CoinAnk-api的OpenAPI 3.0.1规范，服务info.version为1.0.0，servers为https://open-api.coinank.com。所选四个数据路径要求header apikey且标VIP1以上；错误码根路径只列apikey，未标独立VIP等级。虽然security数组为空，仍按具体参数要求认证。文件可读不证明接口在线、本人已订阅或网页VIP与API通用。
检查结果：规范入口、参数认证和API权限明确，未用空security推匿名业务可用。
2. 核币种与完整交易对
/api/baseCoin/list和/api/baseCoin/symbols分别发现coins/pairs，productType可SWAP/SPOT；symbols还有exchange，返回symbol/baseCoin/exchangeName。文档币种样例含1000等单位前缀和别名，不自行合并。样例与所列旧场所不是当前覆盖，保存本人已有返回的具体标识再比较。
检查结果：场所、币种、交易对和产品类型分列，旧样例没有被冒充支持清单。
3. 区分两种历史
/api/liquidation/history要求exchange/symbol/interval，返回每交易对longTurnover与shortTurnover，字段定义USD。/api/liquidation/aggregated-history要求baseCoin/interval/endTime，返回all内两值；baseCoin样例写BTCUSDT与币种字段含义有歧义，先用发现材料核，不能自动照抄或当全市场穷举。两路径同事件不可重复相加，模型图也不作为已发生历史。
检查结果：历史对象和USD单位明确，聚合范围与歧义保留且未重复加总。
4. 保存窗口与未定义契约
endTime说明返回该时间之前的数据，示例endTime/ts为13位Unix值；正文未明确单位、边界是否含、时区和完整分页终止规则，先保留原值并核转换。size最大500，interval列1m至1d；返回500条不证窗口已齐。没有公开契约的部分不编cursor方案或保证排序。
检查结果：原时间值、粒度、数量及未知边界保留，没有用样例推完整历史。
5. 分开HTTP、业务错误与缺字段
错误表code字符串1成功、0系统错误，-2限流、-3无效key、-4未订阅、-5无时间级别权限、-6无端点权限、-7超过范围。须同时核HTTP与success/code。history将shortTurnover schema写integer但样例含小数；aggregate schema要求两值而样例缺shortTurnover，不能截断小数或把缺字段补零，记录契约差异并核实际材料。
检查结果：错误类别、实际返回和schema/样例差异明确，失败或缺字段未算零清算。
怎样确认完成
- 形成带对象、单位、返回状态和规范缺项的清算历史口径表；未调用接口或验证网页交互。
常见错误与边界
- 文档当前可读不说明样例时点与当前市场一致。
- 预测、热图、榜单和历史记录不能互相作为真实性证明。