获取账户授权变更记录
1. 概述与典型用途
查询指定账户的代币授权（Approve）变更历史记录，支持按授权记录或转账记录维度查询。
- 典型用途：追踪授权金额变化、审查授权使用情况、合约授权安全分析。
- 何时不要用：查看当前授权列表用「获取授权列表」。
limit最大值为 50。
2. 接口与鉴权
GET /api/account/approve/change
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
contract_address | string | 是 | — | 合约地址 |
from_address | string | 是 | — | 发起方地址 |
to_address | string | 是 | — | 接收方地址 |
start | integer | 否 | 0 | 起始编号（偏移量） |
limit | integer | 否 | 10 | 每页数量，最大 50 |
type | string | 否 | approve | 记录类型。approve：授权记录；transfer：转账记录 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 记录总数 | — |
rangeTotal | integer | 必返 | 过滤范围内总数 | — |
data | array | 必返 | 变更记录数组，见下 | — |
contractMap | object | 必返 | 涉及地址 → 是否为合约的布尔映射（可为空对象） | — |
contractInfo | object | 可选 | 合约地址 → 标签信息；可为空对象 {}，部分响应不返回；value schema 见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
hash | string | 必返 | 交易哈希 | — |
block | integer | 必返 | 区块高度 | — |
date_created | integer | 必返 | 记录创建时间 | 毫秒时间戳 ms |
from_address | string | 必返 | 发起方地址 | — |
fromAddressTag | string | 可选 | 发起方地址标签；仅当发起方有公开标签时出现（实测 2026-06-02：无标签账户该 key 不存在） | — |
owner_address | string | 必返 | 所有者地址 | — |
to_address | string | 必返 | 接收方地址 | — |
toAddressTag | string | 可选 | 接收方地址标签；仅当接收方有公开标签时出现（实测 2026-06-02：无标签账户该 key 不存在） | — |
contract_address | string | 必返 | 合约地址 | — |
type | string | 必返 | 记录类型：approve 或 transfer | — |
amount_str | string | 必返 | 授权/转账金额（原值字符串） | 需配合 tokenInfo.tokenDecimal 换算 |
unlimited | boolean | 必返 | 是否为无限授权 | — |
revert | boolean | 必返 | 是否已回退 | — |
confirmed | boolean | 必返 | 是否已确认 | — |
contract_ret | string | 必返 | 合约执行结果 | — |
tokenInfo | object | 必返 | 代币元信息；子字段 schema 见下 | — |
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 代币有） | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果 ≠ 错误：无匹配变更记录时返回
200+data: []，属于正常响应。
最后更新于: