Hyblock挂单失衡怎么读？核深度、归一化与场所覆盖
链小知 · 进阶 · 核验 · 依官方文档整理
把被动订单簿与真实成交分开，核当前认证和逐端点支持。
开始前准备
- 仅核公开文档或自己已有的脱敏材料；不申请密钥、下单或转移资金。
- 分别保存产品、场所、单位、时点与数据缺项，错误不记成零。
1. 核当前认证与端点身份
官方当前认证页用https://api.hyblockcapital.com/v2与x-api-key，并明确旧OAuth2 token流程不再使用。catalog的endpointName、exchange、symbol是覆盖发现参数；指标请求的coin字段不能未经核对就替换成catalog的symbol。
检查结果：版本、认证与发现参数分开，未复制旧token流程或暴露key。
2. 先核具体场所和市场类型
bidAsk与bidAskRatio要求coin/timeframe，exchange可单个或逗号分隔，marketTypes可all/spot/perpetuals。文档默认列表含历史场所，不证明每个组合当前可用；按catalog逐端点核，并保存返回metadata.exchanges与unsupportedExchanges。支持部分组合不能当全部成功。
检查结果：场所、市场类型和支持/不支持列表均有记录，未用默认长名单代替覆盖。
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层直接比较；本篇不补文档没有明确写出的价格参照或权重公式。
检查结果：深度范围完整且比较对象一致，单值/双值含义未混淆。
4. 区分原始比率与归一化
Bid Ask Ratio公式为(Bids−Asks)/(Bids+Asks)，范围−1至1；正负表示被动挂买/挂卖失衡，不是净买入成交。advanceFilter默认none直接处理原值；normalize按当前选择缩放到0–100，已不保留原比率尺度，切换选择后的值也不能直接横比。
检查结果：原比率、归一化值与挂单/成交分别保存，没有据挂单推实际买卖。
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状态分别核。
检查结果：原时间值、粒度、排序和缺范围已记录，未知时间/历史完整性未标通过。
怎样确认完成
- 形成一份带场所、深度、尺度、时间和缺项的指标口径表；实际数据未验证。
常见错误与边界
- 挂单会撤销，失衡不证明未来成交。
- 跨现货、永续及不同深度的聚合比率不可无条件比较。