获取指定地址某 TRC20 代币转账列表
1. 概述与典型用途
查询指定地址某 TRC20 代币的转账记录，支持按方向（转入 / 转出）、时间范围等条件过滤。
- 典型用途：钱包某 TRC20 代币流水展示、指定代币转入转出明细查询。
- 何时不要用：查 TRX 转账用「获取指定地址的 TRX 转账列表」；查 TRC10 代币转账用「获取指定地址某 TRC10 代币转账列表」。
2. 接口与鉴权
GET /api/transfer/trc20
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 查询地址 |
trc20Id | string | 是 | — | TRC20 代币合约地址 |
start | integer | 否 | 0 | 起始编号（偏移量）；start + limit ≤ 10000 |
limit | integer | 否 | 20 | 每页数量，最大 50 |
direction | integer | 否 | 1 | 转账方向：1 转出（address 为发送方）、2 转入（address 为接收方）、0 全部 |
start_timestamp | integer | 否 | 1529769600000 | 起始时间，毫秒时间戳 |
end_timestamp | integer | 否 | — | 结束时间，毫秒时间戳 |
db_version | integer | 否 | 0 | 过滤无效转账 |
reverse | boolean | 否 | true | 按降序排列数据 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
code | integer | 必返 | 状态码 | — |
page_size | integer | 必返 | 当前页返回的记录数 | — |
tokenInfo | object | 必返 | TRC20 代币元信息；子字段 schema 见下 | — |
data | array | 必返 | 转账记录数组，见下 | — |
contractMap | object | 可选 | 地址 → 是否为合约的映射 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
hash | string | 必返 | 交易哈希 | — |
block | integer | 必返 | 区块高度 | — |
block_timestamp | integer | 必返 | 区块时间 | 毫秒时间戳 ms |
from | string | 必返 | 发送方地址 | — |
to | string | 必返 | 接收方地址 | — |
amount | string | 必返 | 转账数量（原值）；Approval 类型时固定为 "0" | 需配合 decimals 换算 |
status | integer | 可选 | 交易状态码；仅 Transfer 类型事件存在 | — |
approval_amount | string | 必返 | 授权数量；Transfer 类型时固定为 "0" | — |
approval_amount_unlimited | string | 可选 | 仅当授权量超过 10^(18+decimals) 时出现，值固定为 "unlimited" | — |
event_type | string | 必返 | 事件类型（"Transfer" / "Approval"）；当 from 为合约地址且类型为 Transfer 时置为空字符串 | — |
confirmed | integer | 必返 | 是否已确认；默认 1 | — |
contract_type | string | 必返 | 合约类型；固定为 "TriggerSmartContract" | — |
contractType | integer | 必返 | 合约类型编号；固定为 31 | — |
revert | integer | 必返 | 是否已回退；1 表示已回退 | — |
contract_ret | string | 必返 | 合约执行结果；默认 "SUCCESS" | — |
direction | integer | 必返 | 转账方向：1 = address 为发送方（转出）、2 = address 为接收方（转入） | — |
decimals | integer | 必返 | 代币精度 | — |
token_name | string | 必返 | 代币合约名称 | — |
id | string | 必返 | 代币合约地址（= 请求参数 trc20Id） | — |
issue_address | string | 必返 | 代币发行方地址 | — |
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 代币 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 必填参数：
address和trc20Id均为必填，缺少时返回错误。 - 参数违规不报错：
limit > 50、start + limit > 10000等被静默截断。 - 空结果 ≠ 错误：无命中返回
200+data: []，属于正常响应。
最后更新于: