# CoinAnk清算历史怎么核？辨对象、单位和错误返回

整理：链小知（AI 辅助）
资料核对日期：2026-10-14
引用地址：https://lianxiaozhi.com/tools/guides/coinank-liquidation-history-symbol-unit-error-check
难度：进阶
核验方式：官方文档整理，未执行真实账户操作

从官方发布的静态规范核交易对及汇总历史，保留规范不足与样例矛盾。

## 使用工具
- [CoinAnk](https://lianxiaozhi.com/tools/coinank) · [官方入口](https://coinank.com/)

## 前置条件
- 仅核公开文档或自己已有的脱敏材料；不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项，错误不记成零。

## 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推匿名业务可用。
依据：[CoinAnk：静态OpenAPI选定路径](https://docs.coinank.com/docs/api/version-1.html)

## 2. 核币种与完整交易对

/api/baseCoin/list和/api/baseCoin/symbols分别发现coins/pairs，productType可SWAP/SPOT；symbols还有exchange，返回symbol/baseCoin/exchangeName。文档币种样例含1000等单位前缀和别名，不自行合并。样例与所列旧场所不是当前覆盖，保存本人已有返回的具体标识再比较。

核对结果：场所、币种、交易对和产品类型分列，旧样例没有被冒充支持清单。
依据：[CoinAnk：静态OpenAPI选定路径](https://docs.coinank.com/docs/api/version-1.html)

## 3. 区分两种历史

/api/liquidation/history要求exchange/symbol/interval，返回每交易对longTurnover与shortTurnover，字段定义USD。/api/liquidation/aggregated-history要求baseCoin/interval/endTime，返回all内两值；baseCoin样例写BTCUSDT与币种字段含义有歧义，先用发现材料核，不能自动照抄或当全市场穷举。两路径同事件不可重复相加，模型图也不作为已发生历史。

核对结果：历史对象和USD单位明确，聚合范围与歧义保留且未重复加总。
依据：[CoinAnk：静态OpenAPI选定路径](https://docs.coinank.com/docs/api/version-1.html)

## 4. 保存窗口与未定义契约

endTime说明返回该时间之前的数据，示例endTime/ts为13位Unix值；正文未明确单位、边界是否含、时区和完整分页终止规则，先保留原值并核转换。size最大500，interval列1m至1d；返回500条不证窗口已齐。没有公开契约的部分不编cursor方案或保证排序。

核对结果：原时间值、粒度、数量及未知边界保留，没有用样例推完整历史。
依据：[CoinAnk：静态OpenAPI选定路径](https://docs.coinank.com/docs/api/version-1.html)

## 5. 分开HTTP、业务错误与缺字段

错误表code字符串1成功、0系统错误，-2限流、-3无效key、-4未订阅、-5无时间级别权限、-6无端点权限、-7超过范围。须同时核HTTP与success/code。history将shortTurnover schema写integer但样例含小数；aggregate schema要求两值而样例缺shortTurnover，不能截断小数或把缺字段补零，记录契约差异并核实际材料。

核对结果：错误类别、实际返回和schema/样例差异明确，失败或缺字段未算零清算。
依据：[CoinAnk：静态OpenAPI选定路径](https://docs.coinank.com/docs/api/version-1.html)

## 常见错误
- 文档当前可读不说明样例时点与当前市场一致。
- 预测、热图、榜单和历史记录不能互相作为真实性证明。

## 完成检查
- 形成带对象、单位、返回状态和规范缺项的清算历史口径表；未调用接口或验证网页交互。

## 相关知识

## 官方依据
- [CoinAnk：静态OpenAPI选定路径](https://docs.coinank.com/docs/api/version-1.html)