/wallet/getaccount - Tron

Example code for the getaccount REST method. Complete guide on how to use getaccount REST method in GetBlock Web3 documentation.

This endpoint returns the on-chain data for an account, including its TRX balance in SUN, permissions, TRC-10 asset balances, and staking state.

This is a read endpoint. It is also served by the Solidity node at https://go.getblock.io/<ACCESS-TOKEN>/walletsolidity/getaccount, which returns only confirmed, irreversible data. Use the Solidity node for balance and payment verification.

Parameters

Parameter	Type	Required	Description
address	string	Yes	Account address, base58 (T...) when visible is true, otherwise hex
visible	boolean	No	Return and accept addresses in base58 format. Default false

Request

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS-TOKEN>/wallet/getaccount' \
--header 'Content-Type: application/json' \
--data-raw '{
  "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "visible": true
}'

JavaScript

example.js

const response = await fetch(
    'https://go.getblock.io/<ACCESS-TOKEN>/wallet/getaccount',
    {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({"address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", "visible": true})
    }
);
console.log(await response.json());

Python

example.py

import requests

response = requests.post(
    'https://go.getblock.io/<ACCESS-TOKEN>/wallet/getaccount',
    headers={'Content-Type': 'application/json'},
    json={"address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g", "visible": true}
)

print(response.json())

Response

{
  "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g",
  "balance": 85623170,
  "create_time": 1675582485000,
  "account_resource": {
    "energy_window_size": 28800000
  },
  "owner_permission": {
    "permission_name": "owner",
    "threshold": 1
  },
  "frozenV2": [
    {
      "type": "ENERGY"
    }
  ],
  "assetV2": [
    {
      "key": "1004977",
      "value": 8888880000
    }
  ]
}

Response Parameters

Field	Type	Description
address	string	The queried account address
balance	integer	TRX balance in SUN (1 TRX = 1,000,000 SUN)
frozenV2	array	Stake 2.0 staking positions by resource type
account_resource	object	Energy-related resource state for the account
assetV2	array	TRC-10 asset balances held by the account

Use Cases

• Balance Display: Show an account's TRX balance and assets

• Staking State: Read an account's Stake 2.0 positions

• Permission Checks: Read an account's owner and active permissions

• Account Activation: Detect whether an address has been activated on-chain

Error Handling

HTTP Status	Message	Description
200	OK	The request succeeded; some TRON errors are returned in the 200 body as an Error field
400	Bad request	The request body is malformed or a required field is missing
500	Internal error	The node failed to process the request