CryptoRank未来解锁为何与其他日历不同？核v3分页、时间与分母
链小知 · 进阶 · 核验 · 依官方文档整理
核返回范围与当前价格估值，不把一页结果当全量，也不把计划解锁当已卖出。
开始前准备
- 准备已有脱敏截图或响应及请求参数、版本、读取时点；未取得数据保持未知。本篇依官方文档整理，未登录、申请密钥、调用业务API或进行交易。
1. 先确认v3路由与权限
未来列表为GET /v3/currencies/upcoming-token-unlocks，标Pro起、每请求1credit。v3用X-Api-Key header，不接受查询参数密钥。旧key可共用不表示旧full-metadata结果结构不变；迁移页只列并行后退役阶段，没有确定停用日。
检查结果：版本、端点和套餐分别有依据，敏感key不进入记录。
2. 按该端点的页号核范围
这是page分页，默认1、最大1000，每页最多25条；daysAhead默认30、1–365，按当天起算含边界。保留sortBy/sortOrder与minValue/minPercentOfMcap筛选；meta.page/pageSize/hasNextPage决定是否还有页，不能套通用cursor或把满25条视为结束。
检查结果：窗口、筛选、页号与hasNextPage可对照，缺下一页仍标未齐。
3. 拆开日聚合与两个时间戳
记录CryptoRank numeric id；同一coin同一日的多个事件合为一条，time是UTC当日开始的UNIX毫秒，不是精确执行时刻。status.timestamp也是毫秒但为服务器响应时间；不能替代解锁日。解锁量字符串是原代币单位，保留精度。
检查结果：币种id、日聚合范围与两个时点分开，没有改写成多次链上执行。
4. 按字段定义比较比例与金额
percentOfMcap指按当前流通口径市值的比例，0.42表示0.42%；percentOfSupply采用max supply、缺时回退total supply，不能当流通占比。unlockValue按当前price乘unlockTokens并四舍五入至整美元；它会随价格变，不是解锁日成交额或卖压。
检查结果：百分数、供应分母、估价时点与整数美元舍入有记录。
5. 用额度与错误判定缺项
credits按用户共享、RPM按key；读取实际status.usedCredits，失败文档称不扣，仅2xx扣。429分别可能RPM、日额度、月额度，按Retry-After秒数；403端点或历史范围权限不足不能记零事件。v3颗粒化后一次旧页面可能需要多次请求，不凭套餐月额度推定免费解锁权限。
检查结果：成功数据与错误/缺页分开，额度成本按实际响应保留。
怎样确认完成
- 得到带时点、页范围与分母说明的解锁记录；未知权限、缺页或计划执行保持未知。
常见错误与边界
- 该端点按日聚合，不能还原完整分配组或实际领取。
- 其他供应商的released/circulating定义不可直接套此处两个比例。