Console

POSTGetAccount

Tron Mainnethttps://tron-mainnet.nodit.io/wallet/getaccount

Query information about an account, including TRX balance, TRC-10 balances, stake information and vote information and permissions etc.

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 (enum)

Account type. Normal is default and omitted; AssetIssue is a TRC-10 issuer; Contract is a smart-contract account.

create_timeint64 (int64)

Account creation timestamp, in milliseconds.

balanceinteger (int64)

TRX balance, in sun (1 TRX = 1,000,000 sun).

account_idstring

Account ID (custom identifier set by the account holder).

frozen_balanceinteger (int64)

Amount of TRX staked, in sun.

expire_timeinteger (int64)

Timestamp (ms) when the unstake operation becomes available.

delegated_frozen_balance_for_bandwidthinteger (int64)

Stake 1.0 — total TRX this account has staked to delegate Bandwidth to others, in sun.

acquired_delegated_frozen_balance_for_bandwidthinteger (int64)

Stake 1.0 — total TRX delegated to this account from others for Bandwidth, in sun.

typestring (enum)

Resource type. BANDWIDTH is the default and omitted from JSON when it would be the value; ENERGY and TRON_POWER appear explicitly.

amountinteger (int64)

Self-staked TRX amount for this resource, in sun. Omitted from JSON when 0.

typestring (enum)

Resource type being unstaked. BANDWIDTH is default and omitted.

unfreeze_amountinteger (int64)

Amount of TRX being unstaked, in sun.

unfreeze_expire_timeinteger (int64)

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 (int64)

Stake 2.0 — total TRX this account has staked to delegate Bandwidth to others, in sun.

acquired_delegated_frozenV2_balance_for_bandwidthinteger (int64)

Stake 2.0 — total TRX delegated to this account from others for Bandwidth, in sun.

net_usageinteger (int64)

Amount of staked Bandwidth used by the account.

free_net_usageinteger (int64)

Amount of free Bandwidth used (per-account daily 600 free Bandwidth allowance).

net_window_sizeinteger (int64)

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 (int64)

Timestamp (ms) of the last time the account consumed staked Bandwidth.

latest_consume_free_timeinteger (int64)

Timestamp (ms) of the last time the account consumed free Bandwidth.

frozen_balance_for_energyobject

Stake 1.0 — self-staked TRX for Energy.

frozen_balanceinteger (int64)

Amount of TRX staked, in sun.

expire_timeinteger (int64)

Timestamp (ms) when the unstake operation becomes available.

delegated_frozen_balance_for_energyinteger (int64)

Stake 1.0 — TRX this account staked to delegate Energy to others, in sun.

acquired_delegated_frozen_balance_for_energyinteger (int64)

Stake 1.0 — TRX delegated to this account from others for Energy, in sun.

delegated_frozenV2_balance_for_energyinteger (int64)

Stake 2.0 — TRX this account staked to delegate Energy to others, in sun.

acquired_delegated_frozenV2_balance_for_energyinteger (int64)

Stake 2.0 — TRX delegated to this account from others for Energy, in sun.

energy_usageinteger (int64)

Amount of Energy used by the account.

latest_consume_time_for_energyinteger (int64)

Timestamp (ms) of the last time the account consumed staked Energy.

energy_window_sizeinteger (int64)

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 (int64)

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 (int64)

Amount of withdrawable SR / voter rewards, in sun.

latest_withdraw_timeinteger (int64)

Timestamp (ms) of the account's last reward withdrawal. Withdrawals are restricted to once per 24 hours.

typestring (enum)

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 (int64)

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.

keysobject[]

List of (address, weight) pairs whose signatures can authorize this permission.

addressstring

Signer address (Base58 if visible=true, hex otherwise).

weightinteger (int64)

Signature weight contributed by this key. Sum of weights of signers must meet the Permission's threshold.

typestring (enum)

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 (int64)

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.

keysobject[]

List of (address, weight) pairs whose signatures can authorize this permission.

addressstring

Signer address (Base58 if visible=true, hex otherwise).

weightinteger (int64)

Signature weight contributed by this key. Sum of weights of signers must meet the Permission's threshold.

typestring (enum)

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 (int64)

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.

keysobject[]

List of (address, weight) pairs whose signatures can authorize this permission.

addressstring

Signer address (Base58 if visible=true, hex otherwise).

weightinteger (int64)

Signature weight contributed by this key. Sum of weights of signers must meet the Permission's threshold.

keystring
valueinteger (int64)
keystring
valueinteger (int64)
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).

keystring
valueinteger (int64)
keystring
valueinteger (int64)
keystring
valueinteger (int64)
keystring
valueinteger (int64)
asset_optimizedboolean

Whether asset-storage optimization is enabled for this account.

X-API-KEY
RequestCU26
cURL
curl -X POST "https://tron-mainnet.nodit.io/wallet/getaccount" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "address": "TUoHaVjx7n5xz8LwPRDckgFrDWhMhuSuJM",
  "visible": true
}'
Response
Example · 200
{
  "account_name": "string",
  "address": "string",
  "type": "Normal",
  "balance": 0,
  "account_id": "string",
  "frozen": [
    {
      "frozen_balance": 0,
      "expire_time": 0
    }
  ],
  "delegated_frozen_balance_for_bandwidth": 0,
  "acquired_delegated_frozen_balance_for_bandwidth": 0,
  "frozenV2": [
    {
      "type": "BANDWIDTH",
      "amount": 0
    }
  ],
  "unfrozenV2": [
    {
      "type": "BANDWIDTH",
      "unfreeze_amount": 0,
      "unfreeze_expire_time": 0
    }
  ],
  "delegated_frozenV2_balance_for_bandwidth": 0,
  "acquired_delegated_frozenV2_balance_for_bandwidth": 0,
  "net_usage": 0,
  "free_net_usage": 0,
  "net_window_size": 0,
  "net_window_optimized": true,
  "latest_consume_time": 0,
  "latest_consume_free_time": 0,
  "account_resource": {
    "frozen_balance_for_energy": {
      "frozen_balance": 0,
      "expire_time": 0
    },
    "delegated_frozen_balance_for_energy": 0,
    "acquired_delegated_frozen_balance_for_energy": 0,
    "delegated_frozenV2_balance_for_energy": 0,
    "acquired_delegated_frozenV2_balance_for_energy": 0,
    "energy_usage": 0,
    "latest_consume_time_for_energy": 0,
    "energy_window_size": 0,
    "energy_window_optimized": true
  },
  "latest_opration_time": 0,
  "is_witness": true,
  "allowance": 0,
  "latest_withdraw_time": 0,
  "owner_permission": {
    "type": "Owner",
    "id": 0,
    "permission_name": "string",
    "threshold": 0,
    "operations": "string",
    "parent_id": 0,
    "keys": [
      {
        "address": "string",
        "weight": 0
      }
    ]
  },
  "witness_permission": {
    "type": "Owner",
    "id": 0,
    "permission_name": "string",
    "threshold": 0,
    "operations": "string",
    "parent_id": 0,
    "keys": [
      {
        "address": "string",
        "weight": 0
      }
    ]
  },
  "active_permission": [
    {
      "type": "Owner",
      "id": 0,
      "permission_name": "string",
      "threshold": 0,
      "operations": "string",
      "parent_id": 0,
      "keys": [
        {}
      ]
    }
  ],
  "asset": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "assetV2": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "asset_issued_name": "string",
  "asset_issued_ID": "string",
  "free_asset_net_usage": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "free_asset_net_usageV2": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "latest_asset_operation_time": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "latest_asset_operation_timeV2": [
    {
      "key": "string",
      "value": 0
    }
  ],
  "asset_optimized": true
}

Last updated