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:

FieldTypeDescription
account_namestringThe account name ( Can be modified through the wallet/updateaccount interface, but only once ).
addressstringAccount address.
create_timeint64Account creation time (account activation time on the TRON network).
balanceint64TRX balance. (sun)
frozen.frozen_balanceint64The total amount of TRX staked by the account to obtain Bandwidth. (For Stake 1.0)
frozen.expire_timeint64The expiration time of the Bandwidth stake operation in Stake 1.0. (The account can perform the unstake operation after this time.)
delegated_frozen_balance_for_bandwidthint64The total amount of TRX staked by the account for others to get Bandwidth. (For Stake 1.0)
acquired_delegated_frozen_balance_for_bandwidthint64The total amount of TRX staked by other accounts for this account to obtain Bandwidth. (For Stake 1.0)
account_resource.frozen_balance_for_energy.frozen_balanceint64The total amount of TRX staked by the account to obtain Energy. (For Stake 1.0)
account_resource.frozen_balance_for_energy.expire_timeint64The expiration time of the Energy stake operation in Stake 1.0. (The account can perform the unstake operation after this time.)
account_resource.delegated_frozen_balance_for_energyint64The total amount of TRX staked by other accounts for this account to obtain Energy. (For Stake 1.0)
account_resource.acquired_delegated_frozen_balance_for_energyint64The total amount of TRX staked by the account for others to get Energy. (For Stake 1.0)
account_resource.delegated_frozenV2_balance_for_energyint64The total amount of TRX staked by the account for others to get Energy. (For Stake 2.0)
account_resource.acquired_delegated_frozenV2_balance_for_energyint64The total amount of TRX staked by other accounts for this account to get Energy. (For Stake 2.0)
account_resource.energy_window_sizeint64The number of block times required for Energy to fully recover. (Decimal precision is 3 if account_resource.energy_window_optimized is true, otherwise 0.)
account_resource.energy_window_optimizedboolIndicates if the Energy recovery window optimization is enabled.
delegated_frozenV2_balance_for_bandwidthint64The total amount of TRX staked by this account for others to obtain Bandwidth. (For Stake 2.0)
acquired_delegated_frozenV2_balance_for_bandwidthint64The total amount of TRX staked by other accounts for this account to obtain Bandwidth. (For Stake 2.0)
frozenV2FreezeV2[]A list of staked TRX information for various resources. (For Stake 2.0. This amount does not include delegated TRX.)
unfrozenV2UnFreezeV2[]A list of unstaking operations. (For Stake 2.0. Each item contains three fields: type (resource type); unfreeze_amount (the amount of unstaked TRX); and unfreeze_expire_time (the start timestamp 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 timestamp of the last time the account consumed Energy. (In milliseconds)
net_usageint64The amount of Bandwidth used.
free_net_usageint64The amount of free Bandwidth used.
net_window_sizeint64The number of block times required for Bandwidth obtained by stake to fully recover.(Decimal precision is 3 if net_window_optimized is true, otherwise 0.)
net_window_optimizedboolIndicates if the net recovery window optimization is enabled.
votesVoteA list of votes cast by the account. Each item contains the Super Representative (SR) address and the corresponding vote count.
latest_opration_timeint64The last operation time.
latest_consume_timeint64The timestamp of the last time the account consumed staked Bandwidth. (In milliseconds)
latest_consume_free_timeint64The timestamp of the last time the account consumed free Bandwidth. (In milliseconds)
is_witnessboolIndicates if the account is a Super Representative (SR), an SR Partner or an SR candidate.
allowanceint64The amount of rewards that can be withdrawn by the account. (Unit: sun)
latest_withdraw_timeint64The timestamp of the account's last reward withdrawal. (In milliseconds. SRs and users can only withdraw rewards once within 24 hours.)
owner_permissionPermissionOwner permission.
witness_permissionPermissionWitness permission.
active_permissionPermissionActive permission.
assetmap<string, int64>The map of TRC-10 Token IDs and their balances held by the account.
assetV2map<string, int64>The map of TRC-10 Token IDs and their balances held by the account. (V2 version is used after allowing tokens with same name)
asset_issued_namestringThe name of the TRC-10 token created by the account.
asset_issued_IDstringThe TRC-10 Token ID created by the account.
free_asset_net_usagemap<string, int64>The amount of free Bandwidth consumed by the account when transferring TRC-10 tokens.
free_asset_net_usageV2map<string, int64>The amount of free Bandwidth consumed by the account when transferring TRC-10 tokens.
asset_optimizedboolWhether the account assert optimization is enabled.
Language
Click Try It! to start a request and see the response here!