Get Account Token Asset Overview

1. Overview & Typical Use

Returns the value overview of all tokens held in a specified account wallet, including balance, price, and asset proportion for each token.

Typical use: asset dashboard, token portfolio analysis, total asset value calculation.
When not to use: for a detailed token list use “Get Account Token List”; for DeFi project participation use “Get Account Participated Projects”.

GET /api/account/token_asset_overview

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

Parameter	Type	Required	Default	Description
`address`	string	Yes	—	Account address (Base58, starts with T)
`sort`	string	No	—	Whether to sort by USD value descending. `true`: sorted; `false`: original order

Top-level

Field	Type	Required	Description	Unit/Precision
`totalAssetInTrx`	number	Required	Total assets converted to TRX	TRX
`totalAssetInUsd`	number	Required	Total assets converted to USD	USD
`totalTokenCount`	integer	Required	Number of token types held	—
`data`	array	Required	Token asset array; see below	—
`refreshTimeInfo`	object	Required	Data refresh time info (includes `type` / `lastUpdateTime`; see sub-table)	—

refreshTimeInfo object

Field	Type	Required	Description	Unit/Precision
`type`	string	Required	Refresh mode (e.g. `realtime`)	—
`lastUpdateTime`	integer	Required	Last update time	s timestamp

data[] elements

Field	Type	Required	Description	Unit/Precision
`tokenId`	string	Required	Token ID (TRX is `_`; TRC20 is contract address)	—
`tokenName`	string	Required	Token name	—
`tokenAbbr`	string	Required	Token abbreviation	—
`tokenDecimal`	integer	Required	Decimal places	—
`tokenCanShow`	integer	Required	Whether to display in UI (`1` show, `0` hide)	—
`tokenType`	string	Required	Token type: `trc10` or `trc20`	—
`tokenLogo`	string	Required	Token logo URL	—
`vip`	boolean	Required	Whether this is a VIP token	—
`balance`	string	Required	Balance (raw value string)	Requires `tokenDecimal` to convert
`tokenPriceInTrx`	number	Required	Token price in TRX	—
`tokenPriceInUsd`	number	Required	Token price in USD	—
`assetInTrx`	number	Required	This token’s asset value in TRX	TRX
`assetInUsd`	number	Required	This token’s asset value in USD	USD
`percent`	number	Required	Proportion of total assets	Decimal

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

Empty result is not an error: when the account holds no tokens, 200 + data: [] is returned, which is a normal response.