获取授权列表

1. 概述与典型用途

查询指定账户的代币授权（Approve）列表，支持按项目或代币维度聚合展示。

GET /api/account/approve/list

参数	类型	必填	默认	说明
`address`	string	是	—	账户地址（Base58，T 开头）
`limit`	integer	否	`10`	每页数量，最大 50
`start`	integer	否	`0`	起始编号（偏移量）
`type`	string	否	`project`	聚合类型：`project`（按项目）或 `token`（按代币）
`transfer`	string	否	—	请求移动端数据时使用 `mobile`
`relatedId`	string	否	—	与移动端配合使用。`type=project` 时为 `project_id`；`type=token` 时为 `token_id`

type=project 与 type=token 返回相同 schema（实测 2026-06-02）；type 仅影响后端聚合排序，不改变字段结构。

顶层

字段	类型	是否必返	说明	单位/精度
`total`	integer	必返	授权记录总数	—
`rangeTotal`	integer	必返	过滤范围内总数	—
`data`	array	必返	授权记录数组，见下；空结果时为 `[]`	—
`contractMap`	object	必返	涉及地址 → 是否为合约的布尔映射	—
`contractInfo`	object	必返	合约地址 → 标签信息；value schema 见下	—
`normalAddressInfo`	object	可选	涉及非合约地址 → 风险信息映射；`data` 为空时不返回；每地址 value 实测含 `publicTag`（string）	—

data[] 元素

字段	类型	是否必返	说明	单位/精度
`amount`	string	必返	授权金额（原值字符串，配合 `tokenInfo.tokenDecimal` 换算）	需配合 decimals
`unlimited`	boolean	必返	是否为无限授权	—
`from_address`	string	必返	授权方地址（Base58）	—
`to_address`	string	必返	被授权方地址（Base58）	—
`contract_address`	string	必返	代币合约地址（Base58）	—
`tokenInfo`	object	必返	代币元信息；子字段 schema 见下	—
`project`	object	必返	项目元信息（见下方子表）	—
`project_id`	string	必返	项目 ID（数值字符串，如 `"8"`）	—
`project_sort`	integer	必返	项目排序键	—
`setApprovalForAll`	boolean	可选	TRC-721 / TRC-1155 NFT 的 `setApprovalForAll(operator, true)` 操作员授权标记;仅 NFT operator-approval 记录返回，普通 TRC-20 approve 记录无此字段（实测样本：`TJvcpCNL3qpPgnQ8YsRsRQSqwCToLAevnZ` 在 contract `TEvqEyCxQHgxUPBUV1JcD5HYreQxxLeKj7`（TRC-721 RFBG）的记录返回 `true`）	—
`fromAddressTag`	string	可选	授权方（`from_address`）的公开标签；仅当 from 地址有标签时返回；基于 Greason v5 代码扫描（待补 reproducing sample）	—
`toAddressTag`	string	可选	被授权方（`to_address`）的公开标签；仅当 to 地址有标签时返回；基于 Greason v5 代码扫描（待补 reproducing sample）	—
`operate_time`	integer	必返	最近操作时间	毫秒时间戳 ms

project 子字段

字段	类型	是否必返	说明	单位/精度
`name`	string	必返	项目名称	—
`logo`	string	必返	项目 logo URL	—
`id`	integer	必返	项目数字 ID	—
`officalWebsite`	string	必返	项目官网 URL（API 字段名故意保留为 `officalWebsite`，即 API 真实拼写，`official` 少了第二个 `i`）	—

contractInfo[<addr>] 对象 schema（8 字段）：

字段	类型	是否必返	说明
`tag1`	string	必返	主标签（项目名 / 合约名 / 交易所名）
`tag1Url`	string	必返	主标签链接 URL（可为空字符串）
`name`	string	必返	合约 / 项目正式名称
`isToken`	boolean	必返	是否代币合约（`true` / `false`）
`vip`	boolean	必返	是否 VIP 实体（`true` / `false`）
`risk`	boolean \| string	必返	风险标签；多数 endpoint 返回 boolean，部分返回字符串风险类型（`blacklist` / `fraud` 等）
`publicTagDesc`	string	必返	公开标签描述；多数账户为空字符串
`publicTag`	string	可选	公开标签（如 `"USDT Token"` / `"Binance"`）；仅知名实体或部分接口返回

tokenInfo 对象 schema（通用 9 字段 + 本接口扩展字段）：

字段	类型	是否必返	说明	单位/精度
`tokenId`	string	必返	代币合约地址（Base58）；TRX 占位符为 `_`	—
`tokenAbbr`	string	必返	代币缩写（如 `USDT` / `TRX`）	—
`tokenName`	string	必返	代币名称	—
`tokenDecimal`	integer	必返	精度位数（`amount` 字段换算所需）	—
`tokenCanShow`	integer	必返	是否可展示（`1` 是 / `0` 否）	—
`tokenType`	string	必返	代币类型（`trc10` / `trc20` / `trc721` / `trc1155`）	—
`tokenLogo`	string	必返	代币 logo URL	—
`tokenLevel`	string	必返	代币等级（已观测值：`"0"` / `"1"` / `"2"` / `"4"`，具体语义以后端定义为准）	—
`vip`	boolean	必返	是否为 VIP 代币	—
`issuerAddr`	string	可选	发行方地址（TRC20 代币有）	—

HTTP 状态码见公共错误说明。本接口要点：