GetAccount - Validation Cloud

Query information about an account, including TRX balance, TRC-10 balances, stake information and vote information and permissions etc. This method will use 30 Compute Units.

Parameters

address - String - Address should be converted to a hex string
visible - Boolean - Optional - Specifies whether the address is in Base58 format (default: false).

Returns

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

Field		Description
account_name	string	The name of the account. The account name can be modified through the wallet/updateaccount interface. The account name can only be changed once.
address	string	Account address
create_time	int64	Account creation time, i.e. account activation time on the TRON network
balance	int64	TRX balance
frozen.frozen_balance	int64	In Stake 1.0, the total amount of TRX staked by the account to obtain bandwidth
frozen.expire_time	int64	In 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_bandwidth	int64	In Stake 1.0, the total amount of TRX staked by the account for others to get bandwidth
acquired_delegated_frozen_balance_for_bandwidth	int64	In 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_balance	int64	In Stake 1.0, the total amount of TRX staked by the account to obtain energy
account_resource.frozen_balance_for_energy.expire_time	int64	In 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_energy	int64	In Stake 1.0, the total amount of TRX staked by the account for others to get energy
account_resource.acquired_delegated_frozen_balance_for_energy	int64	In Stake 1.0, the total amount of TRX staked by other accounts for this account to get energy
account_resource.delegated_frozenV2_balance_for_energy	int64	In Stake 2.0, the total amount of TRX staked by the account for others to get energy
account_resource.acquired_delegated_frozenV2_balance_for_energy	int64	In Stake 2.0, the total amount of TRX staked by other accounts for this account to get energy
account_resource.energy_window_size	int64	The 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_optimized	bool	Whether to optimize energy recover window
delegated_frozenV2_balance_for_bandwidth	int64	In Stake 2.0, the total amount of TRX staked by the account for others to get bandwidth
acquired_delegated_frozenV2_balance_for_bandwidth	int64	In Stake 2.0, the total amount of TRX staked by other accounts for this account to get bandwidth
frozenV2	FreezeV2[]	In Stake 2.0, the total amount of TRX staked to obtain various types of resources does not include the delegated TRX
unfrozenV2	UnFreezeV2[]	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_usage	int64	The amount of energy used by the account
account_resource.latest_consume_time_for_energy	int64	The last time the account consumed energy
net_usage	int64	The amount of bandwidth used by the account
free_net_usage	int64	The amount of free bandwidth used by the account
net_window_size	int64	The 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_optimized	bool	Whether to optimize net recover window
free_asset_net_usageV2	map<string, int64>	The amount of trc10’s free bandwidth used by this account
votes	Vote	The number of votes for each Super Representative
latest_opration_time	int64	The last operation time
latest_consume_time	int64	The last time the account consumed bandwidth
latest_consume_free_time	int64	The last time the account consumed free bandwidth
is_witness	bool	Is Super Representative
allowance	int64	The amount of rewards that can be withdrawn for the account
latest_withdraw_time	int64	The last time the account has withdrawn the reward, the super representative or user can only withdraw the reward once within 24 hours
owner_permission	Permission	owner permissions
witness_permission	Permission	witness permissions
active_permission	Permission	active permission
asset	map<string, int64>	The token id and balance of the TRC10 token in the account
assetV2	map<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_name	string	The name of the TRC10 token created by the account
asset_issued_ID	string	TRC10 token ID created by the account
free_asset_net_usage	map<string, int64>	The amount of free bandwidth consumed by account transferring TRC10 tokens
free_asset_net_usageV2	map<string, int64>	The amount of free bandwidth consumed by account transferring TRC10 tokens

// Result
{
  "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "balance": 13118721520,
  "create_time": 1637411046000,
  "latest_opration_time": 1715145693000,
  "latest_consume_time": 1728490236000,
  "latest_consume_free_time": 1715145693000,
  "net_window_size": 28800000,
  "net_window_optimized": true,
  "account_resource": {
    "latest_consume_time_for_energy": 1727095980000,
    "energy_window_size": 28800000,
    "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"
    }
  ],
  "asset_optimized": true
}

curl https://mainnet.tron.validationcloud.io/v1/<YOUR_API_KEY_HERE>/wallet/getaccount \
    -X POST \
    -H "Content-Type: application/json" \
    -d '
{
  "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "visible": true
}
'