Skip to main content

GetAccount

POST
Query information about an account, including TRX balance, TRC-10 balances, stake information and vote information and permissions etc. (Confirmed state)
Path Parameters
chainstringrequired
Parameter specifying the target chain to query.
networkstringrequired
Parameter specifying the network of the target chain.
Request Body
addressstringrequired
Account address. (Format: Base58 or Hex). Example: TUoHaVjx7n5xz8LwPRDckgFrDWhMhuSuJM
visibleboolean
Optional. Set to true to format addresses in Base58; set to false for hex format. (Default: false)
Responses
account_namestring
Account name. (Can be modified once via wallet/updateaccount).
addressstring
Account address. Base58 if visible=true on the request, hex (21 bytes including the 0x41 prefix) otherwise.
typestring
Account type. Normal is default and omitted; AssetIssue is a TRC-10 issuer; Contract is a smart-contract account.
create_timeint64
Account creation timestamp, in milliseconds.
balanceinteger
TRX balance, in sun (1 TRX = 1,000,000 sun).
account_idstring
Account ID (custom identifier set by the account holder).
Stake 1.0 — TRX staked for Bandwidth. Legacy; new staking uses frozenV2.
frozen_balanceinteger
Amount of TRX staked, in sun.
expire_timeinteger
Timestamp (ms) when the unstake operation becomes available.
delegated_frozen_balance_for_bandwidthinteger
Stake 1.0 — total TRX this account has staked to delegate Bandwidth to others, in sun.
acquired_delegated_frozen_balance_for_bandwidthinteger
Stake 1.0 — total TRX delegated to this account from others for Bandwidth, in sun.
Stake 2.0 — list of self-staked TRX entries by resource type (BANDWIDTH / ENERGY / TRON_POWER). Excludes delegated TRX. Each resource type appears at most once.
typestring
Resource type. BANDWIDTH is the default and omitted from JSON when it would be the value; ENERGY and TRON_POWER appear explicitly.
amountinteger
Self-staked TRX amount for this resource, in sun. Omitted from JSON when 0.
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)
typestring
Resource type being unstaked. BANDWIDTH is default and omitted.
unfreeze_amountinteger
Amount of TRX being unstaked, in sun.
unfreeze_expire_timeinteger
Timestamp (ms) when the unstaked TRX can be withdrawn via wallet/withdrawexpireunfreeze. Wait period = chain param #70 getUnfreezeDelayDays (default 14 days on Mainnet).
delegated_frozenV2_balance_for_bandwidthinteger
Stake 2.0 — total TRX this account has staked to delegate Bandwidth to others, in sun.
acquired_delegated_frozenV2_balance_for_bandwidthinteger
Stake 2.0 — total TRX delegated to this account from others for Bandwidth, in sun.
net_usageinteger
Amount of staked Bandwidth used by the account.
free_net_usageinteger
Amount of free Bandwidth used (per-account daily 600 free Bandwidth allowance).
net_window_sizeinteger
Duration, in blocks, for staked Bandwidth to fully recover. Has decimal precision of 3 if net_window_optimized is true, otherwise 0.
net_window_optimizedboolean
Whether the Bandwidth recovery window optimization is enabled.
latest_consume_timeinteger
Timestamp (ms) of the last time the account consumed staked Bandwidth.
latest_consume_free_timeinteger
Timestamp (ms) of the last time the account consumed free Bandwidth.
Energy resource state for the account. (Bandwidth resource state is on the parent Account directly.)
frozen_balanceinteger
Amount of TRX staked, in sun.
expire_timeinteger
Timestamp (ms) when the unstake operation becomes available.
delegated_frozen_balance_for_energyinteger
Stake 1.0 — TRX this account staked to delegate Energy to others, in sun.
acquired_delegated_frozen_balance_for_energyinteger
Stake 1.0 — TRX delegated to this account from others for Energy, in sun.
delegated_frozenV2_balance_for_energyinteger
Stake 2.0 — TRX this account staked to delegate Energy to others, in sun.
acquired_delegated_frozenV2_balance_for_energyinteger
Stake 2.0 — TRX delegated to this account from others for Energy, in sun.
energy_usageinteger
Amount of Energy used by the account.
latest_consume_time_for_energyinteger
Timestamp (ms) of the last time the account consumed staked Energy.
energy_window_sizeinteger
Duration in blocks for Energy to fully recover. Has decimal precision of 3 if energy_window_optimized is true, otherwise 0.
energy_window_optimizedboolean
Whether the Energy recovery window optimization is enabled.
votesVote[]
List of Vote objects, each containing vote_address (SR address) and vote_count (number of votes).
latest_opration_timeinteger
Timestamp (ms) of the account's last operation. Note: field name is latest_opration_time (missing 'e') — this is the actual protocol spelling; do not rename to 'operation'.
is_witnessboolean
Whether the account is a Super Representative (SR), Partner, or Candidate.
allowanceinteger
Amount of withdrawable SR / voter rewards, in sun.
latest_withdraw_timeinteger
Timestamp (ms) of the account's last reward withdrawal. Withdrawals are restricted to once per 24 hours.
typestring
Permission type. Owner is the default and may be omitted in JSON.
idinteger
Permission ID. 0 = Owner (omitted in JSON), 1 = Witness, 2-8 = Active.
permission_namestring
Human-readable permission name (e.g. owner, active, witness).
thresholdinteger
Sum of signature weights required to authorize an operation under this permission.
operationsstring
32-byte (64 hex characters) bitmap restricting which contract types this permission can sign. Bit N corresponds to ContractType enum value N (see Tron.proto). Only present on Active permissions — Owner and Witness can sign anything within their scope.
parent_idinteger
Parent permission ID. Typically 0 (Owner) for non-Owner permissions.
List of (address, weight) pairs whose signatures can authorize this permission.
addressstring
Signer address (Base58 if visible=true, hex otherwise).
weightinteger
Signature weight contributed by this key. Sum of weights of signers must meet the Permission's threshold.
typestring
Permission type. Owner is the default and may be omitted in JSON.
idinteger
Permission ID. 0 = Owner (omitted in JSON), 1 = Witness, 2-8 = Active.
permission_namestring
Human-readable permission name (e.g. owner, active, witness).
thresholdinteger
Sum of signature weights required to authorize an operation under this permission.
operationsstring
32-byte (64 hex characters) bitmap restricting which contract types this permission can sign. Bit N corresponds to ContractType enum value N (see Tron.proto). Only present on Active permissions — Owner and Witness can sign anything within their scope.
parent_idinteger
Parent permission ID. Typically 0 (Owner) for non-Owner permissions.
List of (address, weight) pairs whose signatures can authorize this permission.
addressstring
Signer address (Base58 if visible=true, hex otherwise).
weightinteger
Signature weight contributed by this key. Sum of weights of signers must meet the Permission's threshold.
Active permissions (up to 8 per account). Each restricts which contract types it can authorize via the operations bitmap.
typestring
Permission type. Owner is the default and may be omitted in JSON.
idinteger
Permission ID. 0 = Owner (omitted in JSON), 1 = Witness, 2-8 = Active.
permission_namestring
Human-readable permission name (e.g. owner, active, witness).
thresholdinteger
Sum of signature weights required to authorize an operation under this permission.
operationsstring
32-byte (64 hex characters) bitmap restricting which contract types this permission can sign. Bit N corresponds to ContractType enum value N (see Tron.proto). Only present on Active permissions — Owner and Witness can sign anything within their scope.
parent_idinteger
Parent permission ID. Typically 0 (Owner) for non-Owner permissions.
List of (address, weight) pairs whose signatures can authorize this permission.
addressstring
Signer address (Base58 if visible=true, hex otherwise).
weightinteger
Signature weight contributed by this key. Sum of weights of signers must meet the Permission's threshold.
TRC-10 token balances keyed by token name. Deprecated — use assetV2 (TIP-382). Map serialized as array of {key, value}.
keystring
TRC-10 token name.
valueinteger
Balance of the token.
TRC-10 token balances keyed by Token ID. Replaces asset to support same-name tokens (TIP-382). Map serialized as array of {key, value}.
keystring
TRC-10 Token ID.
valueinteger
Balance of the token.
asset_issued_namestring
Name of the TRC-10 token issued by this account (only if it issued one — accounts can issue at most one TRC-10).
asset_issued_IDstring
Token ID of the TRC-10 issued by this account (only if it issued one).
Free Bandwidth consumed for TRC-10 transfers, keyed by TRC-10 token name. Deprecated — use V2.
keystring
TRC-10 token name.
valueinteger
Free Bandwidth consumed for transfers of the token.
Free Bandwidth consumed for TRC-10 transfers, keyed by TRC-10 Token ID.
keystring
TRC-10 Token ID.
valueinteger
Free Bandwidth consumed for transfers of the token.
Timestamp (ms) of last asset operation, keyed by TRC-10 token name. Deprecated — use V2.
keystring
TRC-10 token name.
valueinteger
Timestamp of the last operation for the token. (Unit: millisecond)
Timestamp (ms) of last asset operation, keyed by TRC-10 Token ID.
keystring
TRC-10 Token ID.
valueinteger
Timestamp of the last operation for the token. (Unit: millisecond)
asset_optimizedboolean
Whether asset-storage optimization is enabled for this account.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "ERROR_CODE",
  "message": "400"
}
cURL
curl -X POST 'https://tron-mainnet.nodit.io/walletsolidity/getaccount' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "address": "TUoHaVjx7n5xz8LwPRDckgFrDWhMhuSuJM"
  }'