Address resources (TRON)
Get the energy, bandwidth and frozen balances of a TRON account.
# Address resources (TRON)
`GET https://api.rarebl.com/open/address/resources`
The energy and bandwidth of a TRON account, and its frozen balances, to know whether a transfer burns TRX.
**Rate class:** read (5 requests per second, burst 20, per IP). **Available since:** Open API v2.
## Request
Send the parameters as query parameters (GET) or as a JSON object (POST with `Content-Type: application/json`). They are identical either way. No API key is needed: `X-API-KEY` is reserved and ignored.
Example: `curl "https://api.rarebl.com/open/address/resources?chain=tron&address=TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL"`
## Parameters
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `chain` | string | Yes | TRON only. One of: tron. |
| `address` | string | Yes | The TRON address. |
## Responses
### API200 (HTTP 200): OK
Resources of an account with no staked energy (a real TRON reply).
```json
{
"status": 1,
"code": "API200",
"message": "success",
"data": {
"energy": {
"limit": 0,
"used": 0,
"available": 0
},
"bandwidth": {
"free": 600,
"staked": 0,
"used": 158,
"available": 442
},
"frozen": []
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
| Field | Type | Description |
| --- | --- | --- |
| `data.energy` | object | `{limit, used, available}`. |
| `data.bandwidth` | object | `{free, staked, used, available}`. |
| `data.frozen[]` | object[] | Frozen (staked) balances. |
### API400 (HTTP 400): Bad Request
A parameter is missing or malformed. `data.param` names it (here `address`).
```json
{
"status": 0,
"code": "API400",
"message": "Invalid TRON address.",
"data": {
"param": "address"
},
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
### API429 (HTTP 429): Too Many Requests
Rate limited (read class: 5 requests per second, burst 20, per IP). A `Retry-After` header says how long to wait, in seconds.
```json
{
"status": 0,
"code": "API429",
"message": "Too many requests. Please retry shortly.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
### API502 (HTTP 502): Bad Gateway
The node is unavailable, still syncing or timed out. Retry later with a short back-off.
```json
{
"status": 0,
"code": "API502",
"message": "The node is unavailable or timed out. Please try again.",
"data": null,
"go": null,
"meta": {
"requestid": "0123456789abcdef",
"notices": []
}
}
```
## Notes
- Compare with the `energy` and `bandwidth` from [Estimate a transaction](https://docs.rarebl.com/api/tx/estimate): what you lack is burned as TRX.