从看懂市场结构、观察关键价位、跟踪资金与仓位，到验证策略并接入自己的系统，了解 CoinGlass 核心数据分别能回答什么问题、如何组合，以及可以构建哪些工具。
从你想了解的问题开始
CoinGlass 将分散在不同市场的持仓、资金费率、爆仓与订单流，以及清算模型、ETF 和公开钱包仓位连接起来。以下四个场景说明这些数据能提供哪些观察依据，以及如何将它们用于自己的工具。
| 想了解什么 | 主要观察依据 | 可以构建什么 |
|---|---|---|
| 看懂行情背后的市场结构 | 持仓、费率、仓位结构与主动买卖的同步变化 | 市场结构面板、币种观察工具 |
| 观察关键价位与市场风险 | 清算模型分布、盘口挂单与实际强平事件 | 价格分布看板、风险监控与自定义提醒 |
| 跟踪资金与大额仓位动向 | ETF 净流入／流出、Hyperliquid 大额开平仓与当前仓位 | 资金动向看板、巨鲸观察工具、投研报告 |
| 验证策略并接入自己的系统 | 历史序列、持续查询与已支持的实时推送 | 回测数据集、研究数据库、系统数据服务 |
接口组合的权限按其中最高要求选择；用于商业产品时至少需要标准等级。价格、请求上限与历史范围见API 等级与权限。
看懂行情背后的市场结构
用户的问题：价格变化时，持仓规模是否同步变化？资金费率、大户仓位与主动买卖分别呈现什么状态？
组合方式：
- 选择关注币种、交易所范围和周期；价格与大户多空比使用指定交易对，聚合持仓、加权费率与聚合 CVD 使用各自的市场范围。
- 以价格为时间轴，并列展示持仓、费率、多空比和 CVD。例如，价格上涨时，可以同时观察持仓是否增加、费率如何变化，以及主动买卖差额的方向。
- 分别保留各指标的统计范围和单位，形成币种观察面板；将观察到的关系交给历史研究验证。
权限：基础持仓、费率、多空比与价格历史从业余起，聚合 CVD 从初创起；适用 K 线接口的周期权限见时间周期与 interval。
数据口径：持仓金额不是资金净流入，多空比也不是主动成交量。聚合市场与单交易对数据的范围不同。资金费率 K 线包含预测口径，不能直接作为实际结算现金流；CVD 的累计起点由本次请求范围决定，跨市场比较需统一起点和单位。
观察关键价位与市场风险
用户的问题：当前价格附近，模型显示哪些清算密集区域？买卖盘挂单分布在哪里？实际爆仓是否正在增加？
| 观察依据 | 推荐接口 | 能看见什么 |
|---|---|---|
| 模型清算分布 | 币种清算热力图模型 1／模型 2／模型 3 + 清算地图 | 模型清算强度在时间和价格维度的分布 |
| 盘口流动性 | 订单簿历史（热力图） + 大额订单簿 | 买卖盘各价格档位的挂单，以及被跟踪的大额挂单 |
| 已发生的强平 | WebSocket 爆仓推送 + REST 爆仓订单 | 实时爆仓事件，以及最近 7 天内的历史订单 |
组合方式：
- 以同一标的关联清算分布与订单簿数据，分别展示模型强度和挂单数量，并标注各自覆盖的交易所与交易对。
- 接入实际爆仓订单，按时间、方向与金额展示强平事件；可按自己的业务阈值生成提醒。
- 对照价格变化前后的模型分布、挂单变化和实际爆仓，形成盘中风险监控记录。需要快速查看模型关键价位时，可补充清算最大痛点。
权限：订单簿热力图、大额挂单与 REST／WebSocket 爆仓订单从标准起；清算热力图、地图与最大痛点从专业起。使用上表完整组合需要专业及以上。
数据口径：清算强度是模型结果，不能当作实际或预计爆仓金额；模型分布也不代表价格一定到达某处。挂单可能成交或撤销，实际爆仓金额来自强平订单。不同模型分别展示；叠图时按各接口字段说明转换秒／毫秒和数量单位。
跟踪资金与大额仓位动向
用户的问题：ETF 资金流如何变化？Hyperliquid 上的大额钱包在开什么仓、平什么仓，当前持有什么仓位？
| 观察依据 | 推荐接口 | 能看见什么 |
|---|---|---|
| 基金资金流 | BTC ETF 资金流 + ETH ETF 资金流 | 每日总净流入／流出与各基金明细 |
| 大额开平仓记录 | Hyperliquid 鲸鱼提醒 | 最新的鲸鱼开仓、平仓提醒 |
| 当前仓位详情 | Hyperliquid 鲸鱼持仓；按地址查询使用钱包仓位 | 当前仓位、杠杆、未实现盈亏与强平价 |
组合方式：
- 将 ETF 资金流按 UTC 日期整理为基金资金流图表，展示总额与基金明细。
- 将鲸鱼提醒按钱包、币种与时间展示；查询当前持仓，补充仓位规模和风险相关字段。
- 在同一研究看板中分区展示基金资金流与大额钱包仓位，附各自更新时间，生成日报或持续观察记录。
权限：ETF 接口从业余起，Hyperliquid 鲸鱼提醒、鲸鱼持仓与钱包仓位从初创起；商业产品至少需要标准等级。
数据口径：ETF 资金流与钱包仓位变化是不同口径，不能相加或据此认定资金在两者之间转移。鲸鱼提醒不包含完整仓位详情，当前仓位也不能替代完整历史；公开钱包地址本身不代表已知机构身份。
ETF 资金流日报
- 按
timestamp对应的 UTC 日期整理总净流入和基金明细；flow_usd为美元金额，正数为净流入，负数为净流出。 - 将明细中的
etf_ticker与 BTC ETF 列表或 ETH ETF 列表的ticker匹配，补充基金名称、类型和当前 AUM，只匹配资金流实际返回的基金。 - 总净流入已包含基金明细，不能重复相加；当前 AUM 附上
update_timestamp，不能当作历史每日规模。缺失日期保留为空，披露数据更新后覆盖同日期记录。该组合所用接口从业余起，商业产品至少需要标准等级。
验证策略并接入自己的系统
用户的问题：上述指标在历史上有什么表现？如何把历史研究与持续更新的数据接入自己的研究或交易系统？
组合方式：
- 固定标的、市场范围、周期和单位，按各接口的时间参数与分页规则获取历史，保留来源、时间戳和缺失状态。
- 基于已完成周期计算研究特征，划分回测区间，验证自己设定的规则；CVD 分段下载时按主动买入减主动卖出续算，资金费率 K 线不直接作为实际结算现金流。
- 运行阶段按各 REST 接口的更新节奏维护数据，按需订阅已支持的 WebSocket 频道，处理心跳、重连及数据去重。实时推送的覆盖范围以各频道说明为准。
权限与历史范围：基础历史接口从业余起，CVD 从初创起，WebSocket 从标准起。适用基础 K 线接口的最短周期为业余 4 小时、初创 30 分钟、标准及以上 1 分钟；可获取的历史长度因数据类型、交易所、交易对及等级而异，见API 等级与权限。
接入边界：CoinGlass 提供的是数据，策略计算、回测和交易执行由你的系统实现。REST 与 WebSocket 不保证存在逐项对应的完整历史；例如爆仓订单可在最近 7 天范围内补查，其他频道需按各自说明设计存储与恢复流程。合并数据时不能仅凭时间戳去重。