Get Account Resource List (Stake 2.0)
1. Overview & Typical Use
Query the resource list for accounts holding resources under Stake 2.0, including self-staked, received delegations, sent delegations, unstaking, and withdrawable records.
- Typical use: view Stake 2.0 staking records, delegation details, and unstaking progress.
- When not to use: for Stake 1.0 resources use “Get Account Resource List (Stake 1.0)”; for full account info use “Get Account Detail”.
- The sum of
startandlimitmust be less than or equal to 10000.
2. Endpoint & Authentication
GET /api/account/resourcev2
For Base URL and authentication, see Common Network & Authentication.
This endpoint requires an API Key: calls without a Key return 401.
3. Request
Fields
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
address | string | Yes | — | Account address (Base58, starts with T) |
start | integer | No | 0 | Starting offset; start + limit ≤ 10000 |
limit | integer | No | 10 | Page size |
type | integer | No | 0 | Stake type. 0: self-staked, 1: delegated to this account, 2: delegated from this account, 3: unstaking, 4: withdrawable |
resourceType | integer | No | 0 | Resource type. 0: bandwidth and energy, 1: bandwidth only, 2: energy only |
toAddress | string | No | — | Receiver address — used with type=2 to filter delegation records by recipient |
sort | string | No | time | Sort field. With type=2, also supports usage / burnTrx / balance |
order | string | No | desc | Sort direction. asc for ascending |
4. Response
Fields
Top-level
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
total | integer | Required | Total record count | — |
rangeTotal | integer | Required | Total count within the filtered range | — |
data | array | Required | Resource records array; see below | — |
unfreezeData | array | Required | Unfreezing records array (empty array if none); schema same as data[] (split into separate sub-table if observed to differ) | — |
contractMap | object | Required | Address → boolean map of whether it is a contract (always returned, may be empty) | — |
contractInfo | object | Required | Contract address → label info (may be empty object); value schema below | — |
normalAddressInfo | object | Optional | Non-contract address → risk info map; not returned when data is empty; each address value verified to contain only risk (boolean), no other sub-fields | — |
contractInfo[<addr>] object schema (8 fields):
| Field | Type | Required | Description |
|---|---|---|---|
tag1 | string | Required | Primary label (project name / contract name / exchange name) |
tag1Url | string | Required | URL of the primary label (may be an empty string) |
name | string | Required | Formal contract / project name |
isToken | boolean | Required | Whether it is a token contract (true / false) |
vip | boolean | Required | Whether it is a VIP entity (true / false) |
risk | boolean | string | Required | Risk label; most endpoints return boolean, some return a string risk type (blacklist / fraud, etc.) |
publicTagDesc | string | Required | Public label description; empty string for most accounts |
publicTag | string | Optional | Public label (e.g. "USDT Token" / "Binance"); returned only for well-known entities or certain endpoints |
data[] elements
| Field | Type | Required | Description | Unit/Precision |
|---|---|---|---|---|
ownerAddress | string | Required | Staker address | — |
ownerAddressTag | string | Optional | Staker address label | — |
receiverAddress | string | Required | Resource receiver address | — |
receiverAddressTag | string | Optional | Receiver address label | — |
balance | integer | Required | Staked TRX amount | sun |
resource | integer | Required | Resource type: 0 bandwidth, 1 energy | — |
resourceValue | number | Required | Resource value obtained | — |
lockBalance | integer | Required | Locked balance | sun |
lockResourceValue | number | Required | Locked resource value | — |
expireTime | integer | Required | Expiry time | ms timestamp |
operationTime | integer | Required | Operation time | ms timestamp |
usageRatioYesterday | number | Optional | Yesterday’s usage ratio | — |
burnTrxYesterday | string | Optional | TRX burned yesterday | TRX |
5. Errors
For HTTP status codes, see Common Errors. Notes for this endpoint:
- API Key Required: returns 401 if not provided (see Common Network & Authentication).
- Invalid parameters silently accepted:
start + limit > 10000etc. are silently truncated/capped and return200; do not rely on errors to surface parameter problems. - Empty result is not an error: no Stake 2.0 records returns
200+data: [], which is a normal response.
Last updated on: