获取账户钱包代币概览
1. 概述与典型用途
查询指定账户钱包中所有代币的价值概览，包含每种代币的余额、价格和资产占比信息。
- 典型用途：资产仪表盘、代币组合分析、总资产价值计算。
- 何时不要用：查询代币详细列表用「获取账户代币列表」；查询 DeFi 项目参与情况用「获取账户参与的项目」。
2. 接口与鉴权
GET /api/account/token_asset_overview
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址（Base58，T 开头） |
sort | string | 否 | — | 是否按美元价值降序排序。true：排序；false：保持原顺序 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
totalAssetInTrx | number | 必返 | 全部资产折合 TRX | TRX |
totalAssetInUsd | number | 必返 | 全部资产折合 USD | USD |
totalTokenCount | integer | 必返 | 持有的代币种类数 | — |
data | array | 必返 | 代币资产数组，见下 | — |
refreshTimeInfo | object | 必返 | 数据刷新时间信息（含 type / lastUpdateTime，见子表） | — |
refreshTimeInfo 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
type | string | 必返 | 刷新模式（如 realtime） | — |
lastUpdateTime | integer | 必返 | 最后更新时间 | 秒时间戳 s |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币 ID（TRX 为 _，TRC20 为合约地址） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenAbbr | string | 必返 | 代币简称 | — |
tokenDecimal | integer | 必返 | 精度位数 | — |
tokenCanShow | integer | 必返 | 是否在界面显示（1 显示，0 不显示） | — |
tokenType | string | 必返 | 代币类型：trc10 或 trc20 | — |
tokenLogo | string | 必返 | 代币 Logo URL | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
balance | string | 必返 | 余额（原值字符串） | 需配合 tokenDecimal 换算 |
tokenPriceInTrx | number | 必返 | 代币对 TRX 价格 | — |
tokenPriceInUsd | number | 必返 | 代币对 USD 价格 | — |
assetInTrx | number | 必返 | 该代币资产折合 TRX | TRX |
assetInUsd | number | 必返 | 该代币资产折合 USD | USD |
percent | number | 必返 | 占总资产比例 | 小数 |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果 ≠ 错误：账户无代币时返回
200+data: []，属于正常响应。
最后更新于: