获取账户列表

1. 概述与典型用途

按余额、投票权等维度排序查询 TRON 网络账户列表，支持分页。

典型用途：富豪榜展示、全网账户概览、按排序字段筛选账户。
何时不要用：查询单个账户详情用「获取账户详细信息」；查询账户代币持仓用「获取账户代币列表」。
start 与 limit 的值之和必须小于或等于 10000，且 limit 最大值为 50。

2. 接口与鉴权

GET /api/account/list

Base URL 与鉴权见公共网络与鉴权说明。

3. 请求

字段

参数	类型	必填	默认	说明
`start`	integer	否	`0`	起始编号（偏移量）；`start + limit ≤ 10000`
`limit`	integer	否	`10`	每页数量，最大 50
`sort`	string	否	`-balance`	排序字段。支持 `balance`、`power`、`totaltransactioncount`，前缀 `-` 表示降序
`address`	string	否	—	账户地址；传入时仅返回该地址的记录

4. 响应

字段

顶层

字段	类型	是否必返	说明	单位/精度
`total`	integer	必返	命中总数（上限 10000，用于分页）	—
`account_number`	integer	必返	全网账户总数	—
`last_24h_account_change`	integer	必返	最近 24 小时新增账户数	—
`rangeTotal`	integer	必返	过滤范围内总数	—
`data`	array	必返	账户记录数组，见下	—
`contractMap`	object	可选	地址 → 是否为合约的映射	—
`contractInfo`	object	可选	合约地址 → 标签信息映射(value schema 见下)	—
`normalAddressInfo`	object	可选	地址 → 风险信息	—

data[] 元素

字段	类型	是否必返	说明	单位/精度
`address`	string	必返	账户地址（Base58，T 开头）	—
`addressTag`	string	可选	账户标签；仅当该账户带有标签时出现（大多数地址无此字段）	—
`addressTagLogo`	string	必返	标签 Logo URL（无标签时为空字符串）	—
`balance`	integer	必返	TRX 余额	sun（1 TRX = 10^6 sun）
`unstakingBalance`	integer	必返	解质押中的余额	sun
`power`	integer	必返	投票权（TRON Power）	sun
`totalBalance`	integer	必返	总余额（含质押等）	sun
`totalTransactionCount`	integer	必返	交易总数	—
`trxRatio`	string	必返	该账户 TRX 占全网比例	小数字符串
`latestOperationTime`	integer	必返	最近操作时间	毫秒时间戳 ms
`updateTime`	integer	必返	更新时间	毫秒时间戳 ms

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"`）；仅知名实体或部分接口返回

5. 错误

HTTP 状态码见公共错误说明。本接口要点：

参数违规不报错：limit > 50、start + limit > 10000 等被静默截断/限制并返回 200，不要依赖报错来发现参数问题。
空结果 ≠ 错误：无命中返回 200 + data: []，属于正常响应。

最后更新于: 2026年3月16日

API Keys 获取账户详细信息