# CryptoRank未来解锁为何与其他日历不同？核v3分页、时间与分母

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

核返回范围与当前价格估值，不把一页结果当全量，也不把计划解锁当已卖出。

## 使用工具
- [CryptoRank API](https://lianxiaozhi.com/tools/cryptorank-api) · [官方入口](https://cryptorank.io/public-api)

## 前置条件
- 准备已有脱敏截图或响应及请求参数、版本、读取时点；未取得数据保持未知。本篇依官方文档整理，未登录、申请密钥、调用业务API或进行交易。

## 1. 先确认v3路由与权限

未来列表为GET /v3/currencies/upcoming-token-unlocks，标Pro起、每请求1credit。v3用X-Api-Key header，不接受查询参数密钥。旧key可共用不表示旧full-metadata结果结构不变；迁移页只列并行后退役阶段，没有确定停用日。

核对结果：版本、端点和套餐分别有依据，敏感key不进入记录。
依据：[CryptoRank：未来解锁列表](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/upcoming-token-unlocks.md)
依据：[CryptoRank：认证与额度归属](https://docs.cryptorank.io/authentication.md)
依据：[CryptoRank：v3迁移](https://docs.cryptorank.io/migration/overview.md)

## 2. 按该端点的页号核范围

这是page分页，默认1、最大1000，每页最多25条；daysAhead默认30、1–365，按当天起算含边界。保留sortBy/sortOrder与minValue/minPercentOfMcap筛选；meta.page/pageSize/hasNextPage决定是否还有页，不能套通用cursor或把满25条视为结束。

核对结果：窗口、筛选、页号与hasNextPage可对照，缺下一页仍标未齐。
依据：[CryptoRank：未来解锁列表](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/upcoming-token-unlocks.md)

## 3. 拆开日聚合与两个时间戳

记录CryptoRank numeric id；同一coin同一日的多个事件合为一条，time是UTC当日开始的UNIX毫秒，不是精确执行时刻。status.timestamp也是毫秒但为服务器响应时间；不能替代解锁日。解锁量字符串是原代币单位，保留精度。

核对结果：币种id、日聚合范围与两个时点分开，没有改写成多次链上执行。
依据：[CryptoRank：未来解锁列表](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/upcoming-token-unlocks.md)

## 4. 按字段定义比较比例与金额

percentOfMcap指按当前流通口径市值的比例，0.42表示0.42%；percentOfSupply采用max supply、缺时回退total supply，不能当流通占比。unlockValue按当前price乘unlockTokens并四舍五入至整美元；它会随价格变，不是解锁日成交额或卖压。

核对结果：百分数、供应分母、估价时点与整数美元舍入有记录。
依据：[CryptoRank：未来解锁列表](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/upcoming-token-unlocks.md)

## 5. 用额度与错误判定缺项

credits按用户共享、RPM按key；读取实际status.usedCredits，失败文档称不扣，仅2xx扣。429分别可能RPM、日额度、月额度，按Retry-After秒数；403端点或历史范围权限不足不能记零事件。v3颗粒化后一次旧页面可能需要多次请求，不凭套餐月额度推定免费解锁权限。

核对结果：成功数据与错误/缺页分开，额度成本按实际响应保留。
依据：[CryptoRank：认证与额度归属](https://docs.cryptorank.io/authentication.md)
依据：[CryptoRank：错误与额度](https://docs.cryptorank.io/errors.md)
依据：[CryptoRank：套餐与颗粒化计费](https://docs.cryptorank.io/migration/plans-and-limits.md)
依据：[CryptoRank：v3迁移](https://docs.cryptorank.io/migration/overview.md)

## 常见错误
- 该端点按日聚合，不能还原完整分配组或实际领取。
- 其他供应商的released/circulating定义不可直接套此处两个比例。

## 完成检查
- 得到带时点、页范围与分母说明的解锁记录；未知权限、缺页或计划执行保持未知。

## 相关知识

## 官方依据
- [CryptoRank：未来解锁列表](https://docs.cryptorank.io/api-reference/vesting-&-token-unlocks/upcoming-token-unlocks.md)
- [CryptoRank：认证与额度归属](https://docs.cryptorank.io/authentication.md)
- [CryptoRank：v3迁移](https://docs.cryptorank.io/migration/overview.md)
- [CryptoRank：错误与额度](https://docs.cryptorank.io/errors.md)
- [CryptoRank：套餐与颗粒化计费](https://docs.cryptorank.io/migration/plans-and-limits.md)