Get Account List

1. Overview & Typical Use

Query the list of TRON network accounts sorted by balance, voting power, or other dimensions, with pagination support.

Typical use: rich-list display, network-wide account overview, filtering accounts by sort field.
When not to use: for a single account’s detail use “Get Account Detail”; for token holdings use “Get Account Token List”.
The sum of start and limit must be less than or equal to 10000, and limit has a maximum of 50.

GET /api/account/list

For Base URL and authentication, see Common Network & Authentication.

Parameter	Type	Required	Default	Description
`start`	integer	No	`0`	Starting offset; `start + limit ≤ 10000`
`limit`	integer	No	`10`	Page size, max 50
`sort`	string	No	`-balance`	Sort field. Supports `balance`, `power`, `totaltransactioncount`; `-` prefix = descending
`address`	string	No	—	Account address; when provided, returns only that address’s record

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Total matches (capped at 10000, for pagination)	—
`account_number`	integer	Required	Total accounts on the network	—
`last_24h_account_change`	integer	Required	New accounts in the past 24 hours	—
`rangeTotal`	integer	Required	Total count within the filtered range	—
`data`	array	Required	Account records array; see below	—
`contractMap`	object	Optional	Address → whether it is a contract	—
`contractInfo`	object	Optional	Contract address → label info (value schema below)	—
`normalAddressInfo`	object	Optional	Address → risk info	—

contractInfo[<addr>] object schema (8 fields):

Field	Type	Required	Description
`tag1`	string	Required	Primary label (project name / contract name / exchange name)
`tag1Url`	string	Required	URL of the primary label (may be an empty string)
`name`	string	Required	Formal contract / project name
`isToken`	boolean	Required	Whether it is a token contract (`true` / `false`)
`vip`	boolean	Required	Whether it is a VIP entity (`true` / `false`)
`risk`	boolean \| string	Required	Risk label; most endpoints return boolean, some return a string risk type (`blacklist` / `fraud`, etc.)
`publicTagDesc`	string	Required	Public label description; empty string for most accounts
`publicTag`	string	Optional	Public label (e.g. `"USDT Token"` / `"Binance"`); returned only for well-known entities or certain endpoints

data[] elements

Field	Type	Required	Description	Unit/Precision
`address`	string	Required	Account address (Base58, starts with T)	—
`addressTag`	string	Optional	Account label; only present when the account has a label	—
`addressTagLogo`	string	Required	Label logo URL (empty string if no label)	—
`balance`	integer	Required	TRX balance	sun (1 TRX = 10^6 sun)
`unstakingBalance`	integer	Required	Balance currently being unstaked	sun
`power`	integer	Required	Voting power (TRON Power)	sun
`totalBalance`	integer	Required	Total balance (including staked amounts)	sun
`totalTransactionCount`	integer	Required	Total transaction count	—
`trxRatio`	string	Required	This account’s TRX share of the network	Decimal string
`latestOperationTime`	integer	Required	Most recent operation time	Millisecond timestamp
`updateTime`	integer	Required	Update time	Millisecond timestamp

For HTTP status codes, see Common Errors. Notes for this endpoint:

Invalid parameters are silently accepted: limit > 50, start + limit > 10000, etc. are silently truncated/capped and return 200; do not rely on errors to detect parameter issues.
Empty result is not an error: no matches returns 200 + data: [], which is a normal response.