获取账户资源列表（Stake 2.0）
1. 概述与典型用途
查询在 Stake 2.0 中持有资源的账户的资源列表，包括自质押、他人代理给自己、自己代理给他人、解锁中及待提取的记录。
- 典型用途：查看 Stake 2.0 质押记录、代理资源明细、解锁进度跟踪。
- 何时不要用：查询 Stake 1.0 资源用「获取账户资源列表（Stake 1.0）」；查询账户完整信息用「获取账户详细信息」。
start与limit的值之和必须小于或等于 10000。
2. 接口与鉴权
GET /api/account/resourcev2
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 账户地址（Base58，T 开头） |
start | integer | 否 | 0 | 起始编号（偏移量）；start + limit ≤ 10000 |
limit | integer | 否 | 10 | 每页数量 |
type | integer | 否 | 0 | 质押类型。0：自质押，1：他人代理给自己，2：自己代理给他人，3：解锁中，4：待提取 |
resourceType | integer | 否 | 0 | 资源类型。0：带宽与能量，1：仅带宽，2：仅能量 |
toAddress | string | 否 | — | 接收方地址——与 type=2 配合使用，按指定接收方过滤代理记录 |
sort | string | 否 | time | 排序字段。type=2 时还支持 usage / burnTrx / balance |
order | string | 否 | desc | 排序方式。asc 为升序 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
total | integer | 必返 | 记录总数 | — |
rangeTotal | integer | 必返 | 过滤范围内总数 | — |
data | array | 必返 | 资源记录数组，见下 | — |
unfreezeData | array | 必返 | 解冻中的记录数组（无时为空数组）；schema 同 data[]（若实测不同再分表） | — |
contractMap | object | 必返 | 地址 → 是否为合约的映射（始终返回，可为空对象） | — |
contractInfo | object | 必返 | 合约地址 → 标签信息（可为空对象）；value schema 见下 | — |
normalAddressInfo | object | 可选 | 涉及非合约地址 → 风险信息映射；data 为空时不返回；每地址 value 实测仅含 risk（boolean），无其他子字段 | — |
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"）；仅知名实体或部分接口返回 |
data[] 元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
ownerAddress | string | 必返 | 质押发起方地址 | — |
ownerAddressTag | string | 可选 | 发起方地址标签 | — |
receiverAddress | string | 必返 | 资源接收方地址 | — |
receiverAddressTag | string | 可选 | 接收方地址标签 | — |
balance | integer | 必返 | 质押 TRX 数量 | sun |
resource | integer | 必返 | 资源类型：0 带宽，1 能量 | — |
resourceValue | number | 必返 | 获得的资源值 | — |
lockBalance | integer | 必返 | 锁定余额 | sun |
lockResourceValue | number | 必返 | 锁定资源值 | — |
expireTime | integer | 必返 | 过期时间 | 毫秒时间戳 ms |
operationTime | integer | 必返 | 操作时间 | 毫秒时间戳 ms |
usageRatioYesterday | number | 可选 | 昨日使用率 | — |
burnTrxYesterday | string | 可选 | 昨日燃烧 TRX | TRX |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回 401（见公共网络与鉴权说明）。
- 参数违规不报错：
start + limit > 10000等被静默截断/限制并返回200，不要依赖报错来发现参数问题。 - 空结果 ≠ 错误：账户无 Stake 2.0 记录时返回
200+data: []，属于正常响应。
最后更新于: