Get TRC10 Token Holders

1. Overview & Typical Use

Returns the holder list for a TRC10 token, sorted by holding amount in descending order by default.

Typical use: TRC10 token holder rankings, whale analysis.
When not to use: for TRC20/TRC721/TRC1155 token holders use “Get TRC20/TRC721/TRC1155 Token Holders”.

GET /api/tokenholders

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

Parameter	Type	Required	Default	Description
`address`	string	Yes	—	TRC10 issuer address or token ID
`holder_address`	string	No	—	TRC10 holder address
`start`	integer	No	`0`	Start index; `start + limit ≤ 10000`
`limit`	integer	No	`10`	Items per page, max 50
`sort`	string	No	`-balance`	Sort order: `-balance` descending, `balance` ascending

Top-level

Field	Type	Required	Description	Unit/Precision
`total`	integer	Required	Number of hits (cap 10000)	—
`rangeTotal`	integer	Required	True total number of holders	—
`contractMap`	object	Required	Address → whether the address is a contract	—
`contractInfo`	object	Optional	Contract address → label info (present when contract addresses are involved)	—
`account_number`	integer	Optional	Total account count (only when `address=_`, i.e. TRX)	—
`last_24h_account_change`	integer	Optional	Account count change in the last 24 hours (only for TRX)	—
`data`	array	Required	Holder list; see below	—

data[] elements (TRX, i.e. address=_)

Field	Type	Required	Description	Unit/Precision
`address`	string	Required	Holder address	—
`balance`	integer	Required	Staking vote balance	sun
`totalBalance`	integer	Required	Total balance (including unstaking)	sun
`unstakingBalance`	integer	Required	Balance currently unstaking	sun
`power`	integer	Required	Voting power	—
`trxRatio`	string	Required	Proportion of total TRX supply (high-precision string)	decimal
`index`	integer	Required	Rank index	—
`updateTime`	integer	Required	Last update time	Millisecond timestamp
`latestOperationTime`	integer	Required	Most recent operation time	Millisecond timestamp
`srTag`	boolean	Required	Whether this is a Super Representative	—
`srName`	string	Required	SR name (empty string when not an SR)	—
`foundationTag`	boolean	Required	Whether this is a Foundation address	—
`addressTagLogo`	string	Required	Address tag logo URL (may be empty string)	—
`analysisShow`	boolean	Required	Whether to show in analytics	—

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