GetAccount

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
}
'

Last updated

Was this helpful?