# CoinGlass热图就是已清算吗？核模型、真实历史和时间单位

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

将估算矩阵与已发生清算记录分开，避免读错索引、交易范围和套餐权限。

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

## 前置条件
- 准备已有脱敏截图或响应及请求参数、版本、读取时点；未取得数据保持未知。本篇依官方文档整理，未登录、申请密钥、调用业务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权限分别保存。
依据：[CoinGlass：v4入口](https://docs.coinglass.com/reference/getting-started-with-your-api.md)
依据：[CoinGlass：认证](https://docs.coinglass.com/reference/authentication.md)
依据：[CoinGlass：交易对清算历史](https://docs.coinglass.com/reference/liquidation-history.md)
依据：[CoinGlass：多交易所清算历史](https://docs.coinglass.com/reference/aggregated-liquidation-history.md)
依据：[CoinGlass：model1热图](https://docs.coinglass.com/reference/liquidation-heatmap.md)

## 2. 保留model和热图范围

Pair model1/model2使用exchange、交易对symbol和range，例如12h/24h/3d/7d/30d/90d/180d/1y。已读两模型文档给同样算法描述，未解释差异；保留模型路径，不将切换模型前后的强度直接比较或推定网页默认模型。它们都标Professional/Enterprise。

核对结果：model、对象、range与观察时点明确，未解释模型差异保留未知。
依据：[CoinGlass：model1热图](https://docs.coinglass.com/reference/liquidation-heatmap.md)
依据：[CoinGlass：model2热图](https://docs.coinglass.com/reference/liquidation-heatmap-model2.md)

## 3. 索引映射不当时间或真实金额

liquidation_leverage_data条目为[X索引,Y索引,强度]，Y索引对应y_axis价格；前两项不是时间戳或价格值。price_candlesticks为秒时间加OHLC与美元成交量。第三项正文注释叫leverage，内嵌OpenAPI样例又称USD liquidation amount，保留此不一致，不据其重建账户杠杆或加总已清算美元。

核对结果：矩阵索引、价格蜡烛和强度字段分列，单位不明未编解释。
依据：[CoinGlass：model1热图](https://docs.coinglass.com/reference/liquidation-heatmap.md)
依据：[CoinGlass：model2热图](https://docs.coinglass.com/reference/liquidation-heatmap-model2.md)

## 4. 真实历史按毫秒与美元核

Pair history的time/start_time/end_time是毫秒，long_liquidation_usd与short_liquidation_usd样例为字符串；Coin聚合字段是aggregated_long/short_liquidation_usd，样例为数值。聚合指定exchange_list不是全网穷举；重叠交易所/窗口不能重复加总。

核对结果：真实历史与估算分别留表，ms/sec、字符串/数值和汇总范围都明确。
依据：[CoinGlass：交易对清算历史](https://docs.coinglass.com/reference/liquidation-history.md)
依据：[CoinGlass：多交易所清算历史](https://docs.coinglass.com/reference/aggregated-liquidation-history.md)
依据：[CoinGlass：model1热图](https://docs.coinglass.com/reference/liquidation-heatmap.md)

## 5. 核粒度、数量与缺项

History默认/最大limit1000，返回千条不证明指定日期已齐；Hobbyist列>=4h、Startup>=30m，Standard及以上该表不设粒度限制，仍需按具体返回核。成功样例code为字符串0，HTTP与业务code分开；401/429或未知data形状不能记零清算。

核对结果：端点粒度、limit和业务结果可追溯，缺范围或权限未当市场无事件。
依据：[CoinGlass：交易对清算历史](https://docs.coinglass.com/reference/liquidation-history.md)
依据：[CoinGlass：多交易所清算历史](https://docs.coinglass.com/reference/aggregated-liquidation-history.md)
依据：[CoinGlass：认证](https://docs.coinglass.com/reference/authentication.md)
依据：[CoinGlass：错误与限流](https://docs.coinglass.com/reference/responses-error-codes.md)

## 常见错误
- 数据模型的清算层级不等该价位一定发生清算。
- 样例JSON带注释/逗号和空schema不能代替生产返回验收。

## 完成检查
- 得到估算与真实历史分开的口径记录；实际数据、模型差异和个人仓位未验证。

## 相关知识

## 官方依据
- [CoinGlass：v4入口](https://docs.coinglass.com/reference/getting-started-with-your-api.md)
- [CoinGlass：认证](https://docs.coinglass.com/reference/authentication.md)
- [CoinGlass：错误与限流](https://docs.coinglass.com/reference/responses-error-codes.md)
- [CoinGlass：交易对清算历史](https://docs.coinglass.com/reference/liquidation-history.md)
- [CoinGlass：多交易所清算历史](https://docs.coinglass.com/reference/aggregated-liquidation-history.md)
- [CoinGlass：model1热图](https://docs.coinglass.com/reference/liquidation-heatmap.md)
- [CoinGlass：model2热图](https://docs.coinglass.com/reference/liquidation-heatmap-model2.md)