# Hyblock挂单失衡怎么读？核深度、归一化与场所覆盖

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

把被动订单簿与真实成交分开，核当前认证和逐端点支持。

## 使用工具
- [Hyblock Capital](https://lianxiaozhi.com/tools/hyblock-capital) · [官方入口](https://hyblockcapital.com/)

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

## 1. 核当前认证与端点身份

官方当前认证页用https://api.hyblockcapital.com/v2与x-api-key，并明确旧OAuth2 token流程不再使用。catalog的endpointName、exchange、symbol是覆盖发现参数；指标请求的coin字段不能未经核对就替换成catalog的symbol。

核对结果：版本、认证与发现参数分开，未复制旧token流程或暴露key。
依据：[Hyblock：当前认证](https://docs.hyblockcapital.com/authentication-2408602m0.md)
依据：[Hyblock：catalog](https://docs.hyblockcapital.com/catalog.md)
依据：[Hyblock：失衡比率](https://docs.hyblockcapital.com/bid-ask-ratio.md)

## 2. 先核具体场所和市场类型

bidAsk与bidAskRatio要求coin/timeframe，exchange可单个或逗号分隔，marketTypes可all/spot/perpetuals。文档默认列表含历史场所，不证明每个组合当前可用；按catalog逐端点核，并保存返回metadata.exchanges与unsupportedExchanges。支持部分组合不能当全部成功。

核对结果：场所、市场类型和支持/不支持列表均有记录，未用默认长名单代替覆盖。
依据：[Hyblock：catalog](https://docs.hyblockcapital.com/catalog.md)
依据：[Hyblock：失衡比率](https://docs.hyblockcapital.com/bid-ask-ratio.md)
依据：[Hyblock：被动买卖挂单与深度](https://docs.hyblockcapital.com/bid-ask.md)

## 3. 记录深度区间

depth单值1代表0–1%，两个值1,5代表1–5%而跳过0–1%，最多两个值；可选quote、1、2、5、10、20、full，默认0,5。保留实际请求，不能将0–5%的总量同1–5%环带或quote层直接比较；本篇不补文档没有明确写出的价格参照或权重公式。

核对结果：深度范围完整且比较对象一致，单值/双值含义未混淆。
依据：[Hyblock：失衡比率](https://docs.hyblockcapital.com/bid-ask-ratio.md)
依据：[Hyblock：被动买卖挂单与深度](https://docs.hyblockcapital.com/bid-ask.md)

## 4. 区分原始比率与归一化

Bid Ask Ratio公式为(Bids−Asks)/(Bids+Asks)，范围−1至1；正负表示被动挂买/挂卖失衡，不是净买入成交。advanceFilter默认none直接处理原值；normalize按当前选择缩放到0–100，已不保留原比率尺度，切换选择后的值也不能直接横比。

核对结果：原比率、归一化值与挂单/成交分别保存，没有据挂单推实际买卖。
依据：[Hyblock：失衡比率](https://docs.hyblockcapital.com/bid-ask-ratio.md)
依据：[Hyblock：被动买卖挂单与深度](https://docs.hyblockcapital.com/bid-ask.md)

## 5. 保留时间与缺项

timeframe列1m/5m/15m/1h/4h/1d；limit列5/10/20/50/100/500/1000，默认50；sort默认asc。startTime/endTime默认当前时间，openDate样例为10位Unix值，文档未明确单位和分页终止契约，记录原值并核单位后再转换，不凭样例编完整历史方案。metadata之外的detail.error_code/message须与HTTP状态分别核。

核对结果：原时间值、粒度、排序和缺范围已记录，未知时间/历史完整性未标通过。
依据：[Hyblock：失衡比率](https://docs.hyblockcapital.com/bid-ask-ratio.md)

## 常见错误
- 挂单会撤销，失衡不证明未来成交。
- 跨现货、永续及不同深度的聚合比率不可无条件比较。

## 完成检查
- 形成一份带场所、深度、尺度、时间和缺项的指标口径表；实际数据未验证。

## 相关知识

## 官方依据
- [Hyblock：当前认证](https://docs.hyblockcapital.com/authentication-2408602m0.md)
- [Hyblock：catalog](https://docs.hyblockcapital.com/catalog.md)
- [Hyblock：失衡比率](https://docs.hyblockcapital.com/bid-ask-ratio.md)
- [Hyblock：被动买卖挂单与深度](https://docs.hyblockcapital.com/bid-ask.md)