getaccount - Tron
getaccount. Returns account details such as balance, permissions, and resources for a given address.
getaccount - tron [Value: 20CU]
Returns account details such as balance, permissions, and resources for a given address.
Use cases
- Also available as GET
- Display a wallet's TRX balance and account age
- Check an account's multi-signature permission structure before signing
Constraints
- Returns an empty object for an address with no on-chain history
- TRC10/TRC20 token balances are not included; use dedicated asset endpoints
- Also available under /walletsolidity/ for confirmed (solidified) data instead of the latest state
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key
Language
Request
Examples
curl --request POST \
--url https://lb.drpc.live/tron/{API-KEY}/wallet/getaccount \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{"address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", "visible": true}'Response
200
{
"address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
"balance": 4459000,
"create_time": 1675582485000,
"latest_opration_time": 1781689986000,
"latest_consume_time": 1764749196000,
"latest_consume_free_time": 1781689986000,
"net_window_size": 28800000,
"net_window_optimized": true,
"account_resource": {
"latest_consume_time_for_energy": 1778753271000,
"energy_window_size": 28800000,
"acquired_delegated_frozenV2_balance_for_energy": 1000000,
"energy_window_optimized": true
},
"owner_permission": {
"permission_name": "owner",
"threshold": 1,
"keys": [
{
"address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
"weight": 1
}
]
},
"active_permission": [
{
"type": "Active",
"id": 2,
"permission_name": "active",
"threshold": 1,
"operations": "7fff1fc0033e0300000000000000000000000000000000000000000000000000",
"keys": [
{
"address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
"weight": 1
}
]
}
],
"frozenV2": [
{},
{
"type": "ENERGY"
},
{
"type": "TRON_POWER"
}
],
"assetV2": [
{
"key": "1004977",
"value": 8888880000
},
{
"key": "1005026",
"value": 8888880000
},
{
"key": "1005157",
"value": 8888888
},
{
"key": "1005168",
"value": 4444444444
},
{
"key": "1005141",
"value": 970000
},
{
"key": "1005074",
"value": 2222222
}
],
"free_asset_net_usageV2": [
{
"key": "1004977",
"value": 0
},
{
"key": "1005026",
"value": 0
},
{
"key": "1005157",
"value": 0
},
{
"key": "1005168",
"value": 0
},
{
"key": "1005141",
"value": 0
},
{
"key": "1005074",
"value": 0
}
],
"asset_optimized": true
}
Request params
idinteger
jsonrpcstring
methodstring
object
addressstring
[Required for GET] The account address to query, in base58check or hex format
visibleboolean
When true, addresses in the request and response are base58check strings; when false (default), they are hex strings
Response
200
Returns account details such as balance, permissions, and resources for a given address.Response params
object
addressstring
The account's address in hex format (or base58 if the request was sent with visible=true).
account_namestring
The custom name assigned to the account, if one has been set.
balanceinteger
Liquid TRX balance, in sun (1 TRX = 1,000,000 sun).
create_timeinteger
Unix timestamp, in ms, when the account was created on-chain.
latest_operation_timeinteger
Timestamp of the last operation performed by this account.
latest_consume_timeinteger
Timestamp of the last time staked (paid) bandwidth was consumed.
latest_consume_free_timeinteger
Timestamp of the last time free bandwidth was consumed.
free_net_usageinteger
Amount of free bandwidth used.
net_usageinteger
Amount of staked (paid) bandwidth used, obtained through staking TRX.
net_window_sizeinteger
Staking time window used to calculate available bandwidth.
net_window_optimizedboolean
Flag indicating the bandwidth window is calculated using the optimized model.
account_resourceobject
Contains details about the account's Energy resource, its consumption window, and any delegations.
object
energy_usageinteger
Amount of Energy consumed.
frozen_balance_for_energyobject
Stake 1.0 balance frozen for Energy.
object
frozen_balanceinteger
The amount of TRX frozen for Energy under Stake 1.0.
expire_timeinteger
Timestamp when this frozen balance becomes eligible for unfreezing.
latest_consume_time_for_energyinteger
Timestamp of the last time the Energy resource was consumed.
energy_window_sizeinteger
Staking time window used to calculate available Energy.
energy_window_optimizedboolean
Flag for the optimized calculation model of the Energy window.
delegated_frozen_balance_for_energyinteger
Stake 1.0 balance delegated to another account for Energy.
delegated_frozenV2_balance_for_energyinteger
Stake 2.0 balance delegated to another account for Energy.
owner_permissionobject
Owner permission group: signature threshold and the list of keys with their weights.
object
permission_namestring
The label identifying this permission group (typically "owner").
thresholdinteger
The minimum combined key weight required to authorize an action under this permission.
keysarray_of_objects
The list of keys belonging to this permission group.
object
addressstring
The address of the key holder.
weightinteger
The signing weight assigned to this key.
active_permissionarray_of_objects
The list of active permissions (multi-sig for regular operations) tied to this account.
object
typestring
The permission category, typically "Active".
idinteger
The numeric identifier of this active permission.
permission_namestring
The label identifying this permission group (typically "active").
thresholdinteger
The minimum combined key weight required to authorize an action under this permission.
operationsstring
A hex-encoded bitmap describing which contract operation types this permission is allowed to authorize.
keysarray_of_objects
The list of keys belonging to this permission group.
object
addressstring
The address of the key holder.
weightinteger
The signing weight assigned to this key.
frozenarray_of_objects
Frozen balances under the Stake 1.0 model for bandwidth.
object
frozen_balanceinteger
The amount of TRX frozen for bandwidth under Stake 1.0.
expire_timeinteger
Timestamp when this frozen balance becomes eligible for unfreezing.
frozenV2array_of_objects
Frozen balances under the Stake 2.0 model, broken down by resource type.
object
typestring
The resource type this frozen entry applies to (e.g. ENERGY or TRON_POWER); omitted for bandwidth.
amountinteger
The amount of TRX frozen for this resource type, in sun.
delegated_frozen_balance_for_bandwidthinteger
Stake 1.0 balance delegated to another account for bandwidth.
delegated_frozenV2_balance_for_bandwidthinteger
Stake 2.0 balance delegated to another account for bandwidth.
assetobject
TRC10 token balances in the legacy format, mapping each token id to its balance amount.
assetV2array_of_objects
TRC10 token balances in the newer format, with extended per-token information.
object
keystring
The identifier of the TRC10 token.
valueinteger
The account's balance of this token.
asset_optimizedboolean
Flag showing that TRC10 asset data is stored in the optimized layout.