获取账户 TRC20 转账记录

1. 概述与典型用途

查询指定账户某 TRC20 代币的转账明细，支持按方向（转出 / 转入 / 授权）过滤，含状态信息。

典型用途：钱包页面展示某代币的转账历史、区分转入转出与授权记录。
何时不要用：查全链 TRC20 转账用「获取 TRC20 & TRC721 转账列表」；查 TRX / TRC10 转账用「获取 TRX & TRC10 转账列表」。

GET /api/token_trc20/transfers-with-status

查询无限授权（unlimited Approval）事件需 db_version=1 + direction=0 同时设置。

顶层

字段	类型	是否必返	说明	单位/精度
`code`	integer	必返	状态码（`200` 表示成功）	—
`page_size`	integer	必返	当前页返回的记录数	—
`tokenInfo`	object	必返	代币元信息；子字段 schema 见下	—
`data`	array	必返	转账记录数组，见下	—
`contractMap`	object	可选	地址 → 是否为合约的映射	—

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`（UNKNOWN，未知）、`1`（NEUTRAL，中性）、`2`（OK，正常）、`3`（SUSPICIOUS，可疑）、`4`（UNSAFE，不安全）	—
`vip`	boolean	必返	是否为 VIP 代币	—

data[] 元素

字段	类型	是否必返	说明	单位/精度
`hash`	string	必返	交易哈希	—
`block`	integer	必返	区块高度	—
`block_timestamp`	integer	必返	区块时间	毫秒时间戳 ms
`from`	string	必返	发送方地址	—
`to`	string	必返	接收方地址	—
`contract_address`	string	必返	代币合约地址	—
`id`	string	必返	代币合约地址（与 `contract_address` 值相同）	—
`amount`	string	必返	转账数量（原值字符串）	需配合 `tokenInfo.tokenDecimal` 换算
`status`	integer	必返	交易状态码	—
`approval_amount`	string	必返	授权数量	—
`approval_amount_unlimited`	string	可选	无限授权标识，值为 `"unlimited"`（仅授权数量无限时出现）	—
`event_type`	string	必返	事件类型	—
`confirmed`	integer	必返	确认状态：`0` 未确认、`1` 已确认	—
`contract_type`	string	必返	合约类型字符串（如 `TriggerSmartContract`）	—
`contractType`	integer	必返	合约类型编号	—
`revert`	integer	必返	是否已回退	—
`contract_ret`	string	必返	合约执行结果	—
`final_result`	string	必返	最终结果	—
`direction`	integer	必返	转账方向：`1` 转出、`2` 转入	—
`issue_address`	string	必返	代币发行方地址	—
`decimals`	integer	必返	代币精度	—
`token_name`	string	必返	代币合约名称	—

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