获取账户代币列表
1. 概述与典型用途
查询指定账户持有的余额大于 0 的代币列表，支持按代币类型、价格、金额等排序与分页。
- 典型用途：账户资产列表、代币持仓展示、特定代币余额查询。
- 何时不要用：查询账户完整详情用「获取账户详细信息」；查询代币转账记录用「获取 TRC20 转账列表」。
limit最大值为 200。
2. 接口与鉴权
GET /api/account/tokens
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址（Base58，T 开头） |
start | integer | 否 | 0 | 起始编号（偏移量） |
limit | integer | 否 | 20 | 每页数量，最大 200 |
hidden | integer | 否 | 0 | 是否隐藏小额代币。0：隐藏，1：显示 |
show | integer | 否 | 0 | 代币类型。0：默认，1：TRC20，2：TRC721，3：全部，4：TRC1155 |
sortBy | integer | 否 | 0 | 排序字段。0：默认，1：价格，2：金额，3：数量 |
sortType | integer | 否 | 0 | 排序方式。0：降序，1：升序 |
token | string | 否 | — | 指定代币 ID 或代币合约地址 |
assetType | integer | 否 | 0 | 资产类型。0 或 1：常规代币，2：收据代币 |
showAvailable | integer | 否 | 0 | 是否只展示有余额可用的代币。1：是 |
tokenType | integer | 否 | 0 | 代币类型过滤。0：全部，其他值见接口说明 |
card | integer | 否 | 0 | 是否返回卡片视图数据。1：是 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 代币总数 | — |
code | integer | 必返 | 接口响应状态码 | — |
status | string | 必返 | 状态标识 | — |
message | string | 必返 | 请求结果消息 | — |
lastUpdateSeconds | integer | 必返 | 数据最后更新时间 | 毫秒时间戳 ms |
data | array | 必返 | 代币记录数组，见下 | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射（始终返回，可为空对象） | — |
contractInfo | object | 必返 | 合约地址 → 标签信息（始终返回，可为空对象） | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tokenId | string | 必返 | 代币 ID（TRX 为 _，TRC20 为合约地址） | — |
tokenName | string | 必返 | 代币名称 | — |
tokenAbbr | string | 必返 | 代币简称 | — |
tokenDecimal | integer | 必返 | 精度位数 | — |
tokenType | string | 必返 | 代币类型：trc10 或 trc20（show=2/show=4 时可返回 trc721/trc1155，具体值以实测响应为准） | — |
tokenCanShow | integer | 必返 | 是否可展示（1：是） | — |
tokenLogo | string | 必返 | 代币 Logo URL | — |
tokenLevel | string | 必返 | 代币等级 | — |
tokenPriceInTrx | number | 可选 | 代币对 TRX 价格；无价格时不出现 | — |
tokenPriceInUsd | number | 可选 | 代币对 USD 价格；无价格时不出现 | — |
balance | string | 必返 | 余额（原值字符串） | 需配合 tokenDecimal 换算 |
amount | string | 可选 | 已换算后的数量（小数字符串）；有价格时出现 | — |
quantity | number | string | 必返 | 持有数量（已换算）；TRX 返回格式化字符串（如 "0.000000"），其他代币返回数字 | — |
amountInUsd | number | 可选 | 美元估值；有价格时出现 | USD |
realTrxAmountInUsd | number | 可选 | 实际 TRX USD 折算；TRX 时出现 | USD |
owner_address | string | 可选 | 代币发行方地址（TRC10/TRC20 均有，TRX 除外） | — |
transferCount | integer | 可选 | 转账总次数（TRX 除外） | — |
nrOfTokenHolders | integer | 可选 | 持有人数（TRX 除外） | — |
vip | boolean | 必返 | 是否为 VIP 代币 | — |
level | string | 可选 | 代币等级（TRC10/TRC20 均有，TRX 除外；TRC10 默认为 "0"） | — |
project | string | 可选 | 合约所属项目名称（TRC20 代币，部分项目有） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回 401（见公共网络与鉴权说明）。
- 空结果 ≠ 错误：账户无代币时返回
200+data: []，属于正常响应。
最后更新于: