获取 TRC10/TRX 转账信息
1. 概述与典型用途
返回 TRC10 代币或 TRX 的转账列表，支持按地址、发行方、时间范围等多维度过滤。
- 典型用途：TRC10/TRX 转账流水查询、地址转入转出明细。
- 何时不要用：查询 TRC20/TRC721 转账用「获取 TRC20 & TRC721 转账列表」；查询 TRC1155 转账用「获取 TRC1155 转账列表」。
start + limit上限 10000，超出部分静默截断。limit最大值为 50。
2. 接口与鉴权
GET /api/asset/transfer
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
start | integer | 否 | 0 | 起始编号；start + limit ≤ 10000 |
limit | integer | 否 | 10 | 每页数量，最大 50 |
name | string | 否 | — | 查询 TRX 转账时填写 trx |
issueAddress | string | 否 | — | TRC10 发行方地址 |
address | string | 否 | — | 查询地址 |
relatedAddress | string | 否 | — | 与 address 参数相同 |
start_timestamp | integer | 否 | — | 开始时间（毫秒时间戳） |
end_timestamp | integer | 否 | — | 结束时间，必须 >= start_timestamp（毫秒时间戳） |
confirm | string | 否 | — | 确认状态：0 已固化，1 未固化，不填返回全部 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 命中总数，上限 10000 | — |
rangeTotal | integer | 必返 | 过滤范围内真实总数 | — |
Data | array | 必返 | 转账记录数组，见下 | — |
contractMap | object | 可选 | 地址 → 是否为合约的映射 | — |
contractInfo | object | 可选 | 合约地址 → 标签信息 | — |
normalAddressInfo | object | 可选 | 地址 → 风险信息 | — |
Data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
blockId | integer | 必返 | 所在区块高度 | — |
transactionHash | string | 必返 | 交易哈希 | — |
timestamp | integer | 必返 | 交易时间 | 毫秒 ms |
transferFromAddress | string | 必返 | 转出地址 | — |
transferFromAddressTag | string | 可选 | 转出地址标签 | — |
transferToAddress | string | 必返 | 转入地址 | — |
transferToAddressTag | string | 可选 | 转入地址标签 | — |
amount | integer | 必返 | 转账金额原值，需配合代币精度换算 | raw |
tokenName | string | 必返 | 代币名称；TRX 时为 _ | — |
finalResult | string | 必返 | 最终执行结果 | — |
contractRet | string | 必返 | 合约执行结果 | — |
confirmed | boolean | 必返 | 是否已固化 | — |
cheatStatus | boolean | 必返 | 是否为欺诈交易 | — |
tokenInfo | object | 可选 | 代币元信息 | — |
fromAddressIsContract | boolean | 必返 | 转出地址是否为合约 | — |
toAddressIsContract | boolean | 必返 | 转入地址是否为合约 | — |
riskTransaction | boolean | 必返 | 是否为风险交易 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 分页上限：
start + limit超过 10000 时静默截断，不返回错误。 - 空结果 ≠ 错误：无匹配记录时返回
200+Data: []，属于正常响应。
最后更新于: