获取账户资源列表（Stake 1.0）
1. 概述与典型用途
查询在 Stake 1.0 中持有资源的账户的资源列表，包括自冻结、为他人冻结及他人为自己冻结的记录。
- 典型用途：查看 Stake 1.0 冻结记录、带宽/能量代理明细。
- 何时不要用：查询 Stake 2.0 资源用「获取账户资源列表（Stake 2.0）」；查询账户完整信息用「获取账户详细信息」。
2. 接口与鉴权
GET /api/account/resource
Base URL 与鉴权见 公共网络与鉴权说明。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址（Base58，T 开头） |
start | integer | 否 | 0 | 起始编号（偏移量），最大 5000 |
limit | integer | 否 | 200 | 每页数量 |
type | integer | 否 | 0 | 质押类型。0：全部，1：为自己冻结，2：为他人冻结，3：他人为自己冻结 |
resourceType | integer | 否 | 0 | 资源类型。0：带宽与能量，1：仅带宽，2：仅能量 |
toAddress | string | 否 | — | 接收方地址——与 type=2 配合使用，按指定接收方过滤代理记录 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 记录总数 | — |
rangeTotal | integer | 必返 | 过滤范围内总数 | — |
data | array | 必返 | 资源记录数组，见下 | — |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
hash | string | 必返 | 交易哈希 | — |
block | integer | 必返 | 区块高度 | — |
timestamp | integer | 必返 | 冻结时间 | 毫秒时间戳 ms |
ownerAddress | string | 必返 | 冻结发起方地址 | — |
ownerAddressTag | string | 可选 | 发起方地址标签 | — |
receiverAddress | string | 必返 | 资源接收方地址 | — |
receiverAddressTag | string | 可选 | 接收方地址标签 | — |
resource | string | 必返 | 资源类型：BANDWIDTH 或 ENERGY | — |
frozenBalance | integer | 必返 | 冻结 TRX 数量 | sun |
expireTime | integer | 必返 | 过期时间 | 毫秒时间戳 ms |
resourceValue | string | 必返 | 获得的资源值 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 空结果 ≠ 错误：账户无 Stake 1.0 冻结记录时返回
200+data: []，属于正常响应。
最后更新于: