获取持有者代币持仓分布
1. 概述与典型用途
返回代币持有者的持仓分布情况，按排名区间统计持有量及占比。
- 典型用途：代币集中度分析、持仓分布饼图展示。
- 何时不要用：查询具体持有者列表用对应的持有者接口。
2. 接口与鉴权
GET /api/tokens/position-distribution
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
tokenId | string | 是 | — | 代币合约地址或 TRC10 代币 ID |
4. 响应
字段
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
expire | integer | 必返 | 缓存过期时间 | 毫秒时间戳 ms |
rank1-10 | string | 必返 | 排名 1-10 持有量合计 | — |
rank1-10_ratio | string | 必返 | 排名 1-10 占比 | 小数比例 |
rank11-50 | string | 必返 | 排名 11-50 合计 | — |
rank11-50_ratio | string | 必返 | 排名 11-50 占比 | 小数比例 |
rank51-100 | string | 必返 | 排名 51-100 合计 | — |
rank51-100_ratio | string | 必返 | 占比 | 小数比例 |
rank101-500 | string | 必返 | 排名 101-500 合计 | — |
rank101-500_ratio | string | 必返 | 占比 | 小数比例 |
other | string | 必返 | 其他合计 | — |
other_ratio | string | 必返 | 其他占比 | 小数比例 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
tokenId为必填参数：不传时返回空对象{}。- 空结果 ≠ 错误：无效
tokenId返回200+{}。
最后更新于: