post
https://api.shasta.trongrid.io/wallet/getaccount
Recipes
🔍
Query TRX Balance and Resources
Open Recipe
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Returns
This API returns the account object, which contains the following fields:
| Field | Type | Description |
|---|---|---|
| account_name | string | Account name. (Can be modified once via wallet/updateaccount). |
| address | string | Account address. |
| create_time | int64 | Account creation timestamp. (Unit: millisecond) |
| balance | int64 | Account's TRX balance. (Unit: sun) |
| account_id | string | Account ID. |
| frozen.frozen_balance | int64 | Total amount of TRX staked by the account for Bandwidth. (Unit: sun, For Stake 1.0) |
| frozen.expire_time | int64 | Timestamp when the unstake operation becomes available. (For Stake 1.0, Unit: millisecond) |
| delegated_frozen_balance_for_bandwidth | int64 | The total amount of TRX staked by this account for other accounts' Bandwidth. (Unit: sun, For Stake 1.0) |
| acquired_delegated_frozen_balance_for_bandwidth | int64 | The total amount of TRX staked by other accounts for this account's Bandwidth. (Unit: sun, For Stake 1.0) |
| account_resource.frozen_balance_for_energy.frozen_balance | int64 | Total amount of TRX staked by the account for Energy. (Unit: sun, For Stake 1.0) |
| account_resource.frozen_balance_for_energy.expire_time | int64 | Timestamp when the Energy unstake operation becomes available. (For Stake 1.0, Unit: millisecond) |
| account_resource.delegated_frozen_balance_for_energy | int64 | The total amount of TRX staked by this account for other accounts' energy. (Unit: sun, For Stake 1.0) |
| account_resource.acquired_delegated_frozen_balance_for_energy | int64 | The total amount of TRX staked by other accounts for this account's Energy. (Unit: sun, For Stake 1.0) |
| account_resource.delegated_frozenV2_balance_for_energy | int64 | The total amount of TRX staked by this account for other accounts' Energy. (Unit: sun, For Stake 2.0) |
| account_resource.acquired_delegated_frozenV2_balance_for_energy | int64 | The total amount of TRX staked by other accounts for this account's Energy. (Unit: sun, For Stake 2.0) |
| account_resource.energy_window_size | int64 | The duration, in blocks, required for Energy to fully recover. Note: The value has a decimal precision of 3 if energy_window_optimized is true, otherwise 0. |
| account_resource.energy_window_optimized | bool | Whether the Energy recovery window optimization is enabled. |
| delegated_frozenV2_balance_for_bandwidth | int64 | The total amount of TRX staked by this account for other accounts' Bandwidth. (Unit: sun, For Stake 2.0) |
| acquired_delegated_frozenV2_balance_for_bandwidth | int64 | The total amount of TRX staked by other accounts for this account's Bandwidth. (Unit: sun, For Stake 2.0) |
| frozenV2 | FreezeV2[] | List of self-staked TRX amounts for Bandwidth and Energy. (Stake 2.0, excludes delegated TRX) |
| unfrozenV2 | UnFreezeV2[] | List of unstaking operations. Each item contains: type (resource type); unfreeze_amount (amount of TRX unstaked), and unfreeze_expire_time (start timestamp when the unstaked TRX can be withdrawn; unit: ms). (For Stake 2.0) |
| account_resource.energy_usage | int64 | Amount of Energy used by the account. |
| account_resource.latest_consume_time_for_energy | int64 | Timestamp of the last time the account consumed staked Energy. (Unit: millisecond) |
| net_usage | int64 | Amount of Bandwidth used. |
| free_net_usage | int64 | Amount of free Bandwidth used. |
| net_window_size | int64 | Duration, in blocks, required for staked Bandwidth to fully recover. Note: The value has a decimal precision of 3 if net_window_optimized is true, otherwise 0. |
| net_window_optimized | bool | Whether the Bandwidth recovery window optimization is enabled. |
| votes | Vote | List of Vote objects, each containing vote_address (SR address) and vote_count (number of votes). |
| latest_opration_time | int64 | Timestamp of the account's last operation. (Unit: millisecond) |
| latest_consume_time | int64 | Timestamp of the last time the account consumed staked Bandwidth. (Unit: millisecond) |
| latest_consume_free_time | int64 | Timestamp of the last time the account consumed free Bandwidth. (Unit: millisecond) |
| is_witness | bool | Whether the account is a Super Representative (SR), Partner, or Candidate. |
| allowance | int64 | The amount of rewards that can be withdrawn by the account. (Unit: sun) |
| latest_withdraw_time | int64 | Timestamp of the account's last reward withdrawal. (Unit: millisecond) |
| owner_permission | Permission | Owner permission object. |
| witness_permission | Permission | Witness permission. |
| active_permission | Permission | Active permission. |
| asset | map<string, int64> | The TRC-10 token balances held by the account. |
| assetV2 | map<string, int64> | TRC-10 token balances, keyed by Token ID. (Replaces 'asset' to support same-name tokens, per TIP-382). |
| asset_issued_name | string | Name of the TRC-10 token created by the account. |
| asset_issued_ID | string | TRC-10 token ID created by the account. |
| free_asset_net_usage | map<string, int64> | Free bandwidth consumed by the account, keyed by TRC-10 Token ID. |
| free_asset_net_usageV2 | map<string, int64> | Free bandwidth consumed by the account, keyed by TRC-10 Token ID. (V2) |
| latest_asset_operation_time | map<string, int64> | Timestamp of the account's last asset operation, keyed by TRC-10 Token ID. (Unit: millisecond) |
| latest_asset_operation_timeV2 | map<string, int64> | Timestamp of the account's last asset operation, keyed by TRC-10 Token ID. (Unit: millisecond. V2) |
| asset_optimized | bool | Whether the account assert optimization is enabled. |