POST
/
95e61622bf6a8af293978377718e3b77
/
wallet
/
getaccountbalance
wallet/getaccountbalance
curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance \
  --header 'Content-Type: application/json' \
  --data '{
  "address": "41608f8da72479edc7dd921e4c30bb7e7cddbe722e",
  "block_identifier": {
    "hash": "<string>",
    "number": 123
  },
  "visible": false
}'
{
  "balance": 123,
  "frozen": [
    {
      "frozen_balance": 123,
      "expire_time": 123
    }
  ],
  "delegated_frozenV2": [
    {
      "type": "<string>",
      "frozen_balance": 123
    }
  ],
  "undelegated_frozenV2": [
    {
      "type": "<string>",
      "unfreeze_amount": 123,
      "unfreeze_expire_time": 123
    }
  ]
}
TRON API method that retrieves the TRX balance and related balance information for a specific account. This method provides comprehensive balance data including available balance, frozen balance, and delegated resources.
Get you own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

  • address — the account address to query balance information for (hex format)
  • block_identifier — optional block identifier to query balance at specific block
  • visible — optional boolean to specify address format (default: false for hex format)

Response

  • balance — available TRX balance (in sun, where 1 TRX = 1,000,000 sun)
  • frozen — array of frozen balance information
    • frozen_balance — amount of TRX frozen
    • expire_time — expiration timestamp for frozen balance
  • delegated_frozenV2 — delegated frozen balance information for v2 staking
  • undelegated_frozenV2 — undelegated frozen balance information for v2 staking

Use case

The wallet/getaccountbalance method is used for:
  • Checking available TRX balance for transactions and transfers.
  • Monitoring frozen balance and staking information.
  • Analyzing delegated resource allocations.
  • Managing account liquidity and resource planning.

Body

application/json
address
string
default:41608f8da72479edc7dd921e4c30bb7e7cddbe722e
required
block_identifier
object
visible
boolean
default:false

Response

200 - application/json

Account balance information

balance
integer

Available TRX balance in sun

frozen
object[]

Frozen balance information

delegated_frozenV2
object[]

Delegated frozen balance v2

undelegated_frozenV2
object[]

Undelegated frozen balance v2