获取账户网页钱包代币信息
1. 概述与典型用途
查询指定账户在网页钱包中持有及关注的代币列表，包括余额、估值与代币元信息。
- 典型用途：钱包资产总览、代币持仓展示、组合估值计算。
- 何时不要用：查指定代币的转账明细用相应的转账列表接口；查资源信息用「获取地址可解冻 TRX 数量」。
2. 接口与鉴权
GET /api/account/wallet
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 查询地址 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
code | integer | 必返 | 状态码 | — |
status | string | 必返 | 状态标识 | — |
message | string | 必返 | 请求结果消息 | — |
count | integer | 必返 | 代币数量 | — |
data | array | 必返 | 代币列表数组，见下 | — |
totalValueInUsd | number | 必返 | 所有代币总估值（浮点数） | USD |
lastUpdateSeconds | integer | 必返 | 数据最后更新时间 | 毫秒时间戳 ms |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
token_id | string | 必返 | 代币 ID（TRX 为 _） | — |
token_abbr | string | 必返 | 代币缩写 | — |
token_name | string | 必返 | 代币名称 | — |
token_type | integer | 必返 | 代币类型：0 TRX、10 TRC10、20 TRC20 | — |
token_decimal | integer | 必返 | 代币精度 | — |
balance | string | 必返 | 代币余额（已换算） | — |
token_value | string | 必返 | 代币估值 | TRX |
token_value_in_usd | string | 必返 | 代币估值 | USD |
token_price_in_usd | string | 必返 | 代币单价 | USD |
token_price | string | 必返 | 代币单价 | TRX |
level | integer | string | 必返 | 代币等级（TRX 为 integer，TRC10 可为 string） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
token_url | string | 可选 | 代币图标 URL；有 logo 的代币才出现此字段（无 logo 的代币该 key 不存在） | — |
frozen | integer | 可选 | Stake 1.0 冻结数量；仅 TRX 类型出现 | sun |
frozenV2 | integer | 可选 | Stake 2.0 冻结数量；仅 TRX 类型出现 | sun |
frozen_token_value_in_usd | number | string | 可选 | Stake 1.0 冻结部分 USD 估值；仅 TRX 类型出现 | USD |
frozenV2_token_value_in_usd | number | string | 可选 | Stake 2.0 冻结部分 USD 估值；仅 TRX 类型出现 | USD |
pair_id | integer | 可选 | 交易对 ID；有价格数据的代币出现 | — |
transferCount | integer | 可选 | 转账次数；无报价代币常有 | — |
nrOfTokenHolders | integer | 可选 | 持有人数；无报价代币常有 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回 401（见公共网络与鉴权说明）。
- 缺少必填参数：
address为必填，缺少时返回400（{"message":"some parameters are invalid or out of range"}），不是 401。 - 空结果 ≠ 错误：无代币持仓返回
200+data: []，属于正常响应。
最后更新于: