Blockworks 历史价格为什么为空：核 assetID、窗口和 point_schema
链小知 · 进阶 · 核验 · 依官方文档整理
按统一Data API规范解析资产序列，区分无匹配、缺值与权限失败。
开始前准备
- 准备有权查看的已有界面记录、配置或脱敏响应；本教程核对材料，不登录、创建配置、生成密钥或调用业务API。
- 各产品权限以当前账户和具体模型为准；文档步骤未作账户或付费功能实测。
1. 先核标识和模型权限
GET /query/tabular/assets/bitcoin等单行方法接受slug、prioritySymbol或assetID；读返回assetID及matchedField，再用规范ID查历史。统一密钥不代表每模型都有权限；核access.tier及原响应。
检查结果：规范实体ID与模型资格分别记录。
2. 核粒度和半开窗口
Asset Price方法为GET /query/timeseries/asset-price/{granularity}/{assetID}，支持5m、1h、1d、1w。用timeframe或start/end其中一种；窗口为[start,end)，粒度放路径。bounds=true只取首尾点，不能当完整序列。
检查结果：粒度、窗口和首尾选项明确。
3. 按响应 schema 解列
单资产响应的key、entity、point_schema、points直接在data；批量才有series。每点先是UTC Unix秒时间，后续值按point_schema字段与单位排列，selections输入顺序不决定列序。null保留缺值。
检查结果：列与单位从该响应解析，缺值不填零。
4. 分别解释空数据和报错
未知序列key可200且points为空、无entity；先核assetID，不推没有交易。401指缺认证，403可为无效key或模型资格不足；404可为模型/粒度/单行标识错误。保留原error和脱敏X-Request-Id。
检查结果：空序列、权限和方法错误分列。
怎样确认完成
- 形成实体ID、窗口、字段单位、缺值与失败原因的解析记录。
常见错误与边界
- ticker不唯一，不能仅按符号连接不同资产。
- 历史价格序列不证明原时点就已取得该数据；本轮未验证实时服务、回填或账户资格。