HomeGuidesAPI ReferenceChangelog
GuidesAPI ReferenceCommunityDiscordBlogFAQBug BountyAnnouncementsChange Log
API Reference

GetAccount

Query information about an account, including TRX balance, TRC-10 balances, stake information and vote information and permissions etc.

Returns

This API returns the account object, which contains the following fields:

FieldDescription
account_namestringThe name of the account. The account name can be modified through the wallet/updateaccount interface. The account name can only be changed once.
addressstringAccount address
create_timeint64Account creation time, i.e. account activation time on the TRON network
balanceint64TRX balance
frozen.frozen_balanceint64In Stake 1.0, the total amount of TRX staked by the account to obtain bandwidth
frozen.expire_timeint64In Stake 1.0, the expiration time of the stake operation performed by the account to obtain bandwidth. The account can perform the unstake operation after that time.
delegated_frozen_balance_for_bandwidthint64In Stake 1.0, the total amount of TRX staked by the account for others to get bandwidth
acquired_delegated_frozen_balance_for_bandwidthint64In Stake 1.0, the total amount of TRX staked by other accounts for this account to get bandwidth
account_resource.frozen_balance_for_energy.frozen_balanceint64In Stake 1.0, the total amount of TRX staked by the account to obtain energy
account_resource.frozen_balance_for_energy.expire_timeint64In Stake 1.0, the expiration time of the stake operation performed by the account to obtain energy. The account can perform the unstake operation after that time.
account_resource.delegated_frozen_balance_for_energyint64In Stake 1.0, the total amount of TRX staked by the account for others to get energy
account_resource.acquired_delegated_frozen_balance_for_energyint64In Stake 1.0, the total amount of TRX staked by other accounts for this account to get energy
account_resource.delegated_frozenV2_balance_for_energyint64In Stake 2.0, the total amount of TRX staked by the account for others to get energy
account_resource.acquired_delegated_frozenV2_balance_for_energyint64In Stake 2.0, the total amount of TRX staked by other accounts for this account to get energy
account_resource.energy_window_sizeint64The number of block times required for to fully recover. If energy_window_optimized is true, energy_window_size's decimal is 3, else is 0. For example, when energy_window_optimized=true, then energy_window_size=1000 means that it takes one block time for energy to fully recovery; if energy_window_optimized=false, then energy_window_size=1000 means that it takes 1000 blocks time for energy to fully recovery
account_resource.energy_window_optimizedboolWhether to optimize energy recover window
delegated_frozenV2_balance_for_bandwidthint64In Stake 2.0, the total amount of TRX staked by the account for others to get bandwidth
acquired_delegated_frozenV2_balance_for_bandwidthint64In Stake 2.0, the total amount of TRX staked by other accounts for this account to get bandwidth
frozenV2FreezeV2[]In Stake 2.0, the total amount of TRX staked to obtain various types of resources does not include the delegated TRX
unfrozenV2UnFreezeV2[]In Stake 2.0, each unstaking information. One of the unstaking information contains three fields: type: resource type; unfreeze_amount: the amount of unstaked TRX; unfreeze_expire_time: the start time stamp when the unstaked TRX can be withdrawn, in ms.
account_resource.energy_usageint64The amount of energy used by the account
account_resource.latest_consume_time_for_energyint64The last time the account consumed energy
net_usageint64The amount of bandwidth used by the account
free_net_usageint64The amount of free bandwidth used by the account
net_window_sizeint64The number of block times required for bandwidth obtained by stake to fully recover. If net_window_optimized is true, net_window_size's decimal is 3, else is 0. For example, when net_window_optimized=true, then net_window_size=1000 means that it takes one block time for bandwidth to fully recovery; if net_window_optimized=false, then net_window_size=1000 means that it takes 1000 blocks time for bandwidth to fully recovery
net_window_optimizedboolWhether to optimize net recover window
free_asset_net_usageV2map<string, int64>The amount of trc10's free bandwidth used by this account
votesVoteThe number of votes for each Super Representative
latest_opration_timeint64The last operation time
latest_consume_timeint64The last time the account consumed bandwidth
latest_consume_free_timeint64The last time the account consumed free bandwidth
is_witnessboolIs Super Representative
allowanceint64The amount of rewards that can be withdrawn for the account
latest_withdraw_timeint64The last time the account has withdrawn the reward, the super representative or user can only withdraw the reward once within 24 hours
owner_permissionPermissionowner permissions
witness_permissionPermissionwitness permissions
active_permissionPermissionactive permission
assetmap<string, int64>The token id and balance of the TRC10 token in the account
assetV2map<string, int64>The token id and balance of the TRC10 token in the account. Note, the V2 version is used after allowing token with same name and the proposal has been activated at present.
asset_issued_namestringThe name of the TRC10 token created by the account
asset_issued_IDstringTRC10 token ID created by the account
free_asset_net_usagemap<string, int64>The amount of free bandwidth consumed by account transferring TRC10 tokens
free_asset_net_usageV2map<string, int64>The amount of free bandwidth consumed by account transferring TRC10 tokens
Language
Click Try It! to start a request and see the response here!