CoinGlass热图就是已清算吗？核模型、真实历史和时间单位
链小知 · 进阶 · 核验 · 依官方文档整理
将估算矩阵与已发生清算记录分开，避免读错索引、交易范围和套餐权限。
开始前准备
- 准备已有脱敏截图或响应及请求参数、版本、读取时点；未取得数据保持未知。本篇依官方文档整理，未登录、申请密钥、调用业务API或进行交易。
1. 先辨数据产品与入口
当前v4 base是open-api-v4.coinglass.com，CG-API-KEY认证；网页Prime不推定API权限。Pair History是指定exchange/symbol的真实历史；Coin aggregated-history以coin symbol与exchange_list汇总。Heatmap则按市场与杠杆估算levels，不能当已发生清算或未来一定执行。
检查结果：产品、端点、交易所、币种/交易对和API权限分别保存。
2. 保留model和热图范围
Pair model1/model2使用exchange、交易对symbol和range，例如12h/24h/3d/7d/30d/90d/180d/1y。已读两模型文档给同样算法描述，未解释差异；保留模型路径，不将切换模型前后的强度直接比较或推定网页默认模型。它们都标Professional/Enterprise。
检查结果：model、对象、range与观察时点明确，未解释模型差异保留未知。
3. 索引映射不当时间或真实金额
liquidation_leverage_data条目为[X索引,Y索引,强度]，Y索引对应y_axis价格；前两项不是时间戳或价格值。price_candlesticks为秒时间加OHLC与美元成交量。第三项正文注释叫leverage，内嵌OpenAPI样例又称USD liquidation amount，保留此不一致，不据其重建账户杠杆或加总已清算美元。
检查结果：矩阵索引、价格蜡烛和强度字段分列，单位不明未编解释。
4. 真实历史按毫秒与美元核
Pair history的time/start_time/end_time是毫秒，long_liquidation_usd与short_liquidation_usd样例为字符串；Coin聚合字段是aggregated_long/short_liquidation_usd，样例为数值。聚合指定exchange_list不是全网穷举；重叠交易所/窗口不能重复加总。
检查结果：真实历史与估算分别留表，ms/sec、字符串/数值和汇总范围都明确。
5. 核粒度、数量与缺项
History默认/最大limit1000，返回千条不证明指定日期已齐；Hobbyist列>=4h、Startup>=30m，Standard及以上该表不设粒度限制，仍需按具体返回核。成功样例code为字符串0，HTTP与业务code分开；401/429或未知data形状不能记零清算。
检查结果：端点粒度、limit和业务结果可追溯，缺范围或权限未当市场无事件。
怎样确认完成
- 得到估算与真实历史分开的口径记录；实际数据、模型差异和个人仓位未验证。
常见错误与边界
- 数据模型的清算层级不等该价位一定发生清算。
- 样例JSON带注释/逗号和空schema不能代替生产返回验收。