获取 TRC20/TRC721/TRC1155 代币持有者
1. 概述与典型用途
返回 TRC20/TRC721/TRC1155 代币的持有者列表，按持有量降序排列。
- 典型用途：代币持有者排行、大户持仓分析、地址持仓查询。
- 何时不要用：查询 TRC10 代币持有者用「获取 TRC10 代币持有者」；查询持仓分布用「获取持有者代币持仓分布」。
2. 接口与鉴权
GET /api/token_trc20/holders
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract_address | string | 否 | — | 合约地址；与 holder_address 至少填一个 |
holder_address | string | 否 | — | 持有者地址；与 contract_address 至少填一个 |
start | integer | 否 | 0 | 起始编号；start + limit ≤ 10000 |
limit | integer | 否 | 10 | 每页数量，最大 50 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数（上限 10000） | — |
rangeTotal | integer | 必返 | 真实持有者总数 | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射（含持有者地址） | — |
contractInfo | object | 必返 | 合约地址 → 标签信息映射；value schema 见下 | — |
trc20_tokens | array | 必返 | 持有者列表，见下 | — |
contractInfo[<addr>] 对象 schema（8 字段）：
| 字段 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
tag1 | string | 必返 | 主标签（项目名 / 合约名 / 交易所名） |
tag1Url | string | 必返 | 主标签链接 URL（可为空字符串） |
name | string | 必返 | 合约 / 项目正式名称 |
isToken | boolean | 必返 | 是否代币合约（true / false） |
vip | boolean | 必返 | 是否 VIP 实体（true / false） |
risk | boolean | string | 必返 | 风险标签；多数 endpoint 返回 boolean，部分返回字符串风险类型（blacklist / fraud 等） |
publicTagDesc | string | 必返 | 公开标签描述；多数账户为空字符串 |
publicTag | string | 可选 | 公开标签（如 "USDT Token" / "Binance"）；仅知名实体或部分接口返回 |
trc20_tokens[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
holder_address | string | 必返 | 持有者地址 | — |
balance | string | 必返 | 持有余额（原值字符串，需配合 decimals 换算） | — |
updateTime | integer | 必返 | 最后更新时间 | 毫秒时间戳 ms |
updateBlock | integer | 必返 | 最后更新区块高度 | — |
addressTag | string | 必返 | 地址标签（无标签时为空字符串） | — |
addressTagLogo | string | 必返 | 地址标签 Logo URL（无标签时为空字符串） | — |
publicTagDesc | string | 必返 | 公共标签描述（可为空字符串） | — |
srTag | boolean | 必返 | 是否为超级代表 | — |
srName | string | 必返 | 超级代表名称（非 SR 时为空字符串） | — |
foundationTag | boolean | 必返 | 是否为基金会地址 | — |
analysisShow | boolean | 必返 | 是否在分析中显示 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
start + limit上限为 10000：超出时被静默截断并返回 200。- 空结果 ≠ 错误：无命中返回
200+trc20_tokens: []。
最后更新于: