wallet/getaccountbalance | TRON

TRON API method that retrieves the TRX balance and related balance information for a specific account. Use it on TRON via Chainstack.

POST /95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance

wallet/getaccountbalance

cURL

curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_identifier": {
    "address": "41608f8da72479edc7dd921e4c30bb7e7cddbe722e"
  },
  "block_identifier": {
    "hash": "0000000004986736812cbf15ffbcdd229bd3d76a595db895719867cc2da3a5bd",
    "number": 77096758
  },
  "visible": false
}
'

200

{
  "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 your own node endpoint today

Start 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

• account_identifier.address — the account address to query. Use base58 with visible: true, or hex with visible: false.
• block_identifier — required object specifying the block to query. Provide both the 32‑byte hash (64 hex chars) and the matching number.
• visible — optional boolean for address format. Default is false (hex).

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.

curl examples

Get current balance with a base58 address (at a specific block):

Shell

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance' \
  --header 'Content-Type: application/json' \
  --data '{
    "account_identifier": { "address": "TZ4UXDV5ZhNW7fb2AMSbgfAEZ7hWsnYS2g" },
    "block_identifier": { "hash": "0000000004986736812cbf15ffbcdd229bd3d76a595db895719867cc2da3a5bd", "number": 77096758 },
    "visible": true
  }'

Get balance at a specific block using a hex address:

Shell

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance' \
  --header 'Content-Type: application/json' \
  --data '{
    "account_identifier": { "address": "41608f8da72479edc7dd921e4c30bb7e7cddbe722e" },
    "block_identifier": { "hash": "0000000004986736812cbf15ffbcdd229bd3d76a595db895719867cc2da3a5bd", "number": 77096758 },
    "visible": false
  }'

• avoid INVALID hex String by providing a real 32‑byte block hash (64 hex chars).
• avoid account_identifier is null by passing account_identifier: { address: ... } rather than a top‑level address.
• avoid block_identifier null and hash length not equals 32 by always including block_identifier.hash with 64 hex chars, and block_identifier.number that matches the same block.

find a valid block hash

Use wallet/getnowblock to fetch the latest block and copy the blockID field as the block_identifier.hash value.

Shell

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getnowblock' \
  --header 'Content-Type: application/json'

Alternatively, get a specific block with wallet/getblockbynum and use its blockID.

working example (auto picks latest block)

Run this to fetch the latest blockID, resolve its block number, and immediately query the balance at that block.

Shell

# requires jq
BLOCK_ID=$(curl -s -X POST \
  'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getnowblock' \
  -H 'Content-Type: application/json' | jq -r '.blockID')
NUMBER=$(curl -s -X POST \
  'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getblockbyid' \
  -H 'Content-Type: application/json' \
  --data "{\"value\": \"$BLOCK_ID\"}" | jq -r '.block_header.raw_data.number')

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance' \
  --header 'Content-Type: application/json' \
  --data "{\n  \"account_identifier\": { \"address\": \"41608f8da72479edc7dd921e4c30bb7e7cddbe722e\" },\n  \"block_identifier\": { \"hash\": \"$BLOCK_ID\", \"number\": $NUMBER },\n  \"visible\": false\n}"

If jq is not available, use Python instead:

Shell

BLOCK_ID=$(curl -s -X POST \
  'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getnowblock' \
  -H 'Content-Type: application/json' | python3 -c 'import sys,json; print(json.load(sys.stdin)["blockID"])')
NUMBER=$(curl -s -X POST \
  'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getblockbyid' \
  -H 'Content-Type: application/json' \
  --data "{\"value\": \"$BLOCK_ID\"}" | python3 -c 'import sys,json; print(json.load(sys.stdin)["block_header"]["raw_data"]["number"])')

curl --request POST \
  --url 'https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/getaccountbalance' \
  --header 'Content-Type: application/json' \
  --data "{\n  \"account_identifier\": { \"address\": \"41608f8da72479edc7dd921e4c30bb7e7cddbe722e\" },\n  \"block_identifier\": { \"hash\": \"$BLOCK_ID\", \"number\": $NUMBER },\n  \"visible\": false\n}"

Body

application/json

account_identifier · object · required

Show child attributes

block_identifier · object · required

Block to query the balance at. Provide both the 32-byte block hash (64 hex chars) and its number; the node validates they match.

Show child attributes

visible · boolean · default: false

Response

200 - application/json

Account balance information

balance · integer

Available TRX balance in sun

frozen · object[]

Frozen balance information

Show child attributes

delegated_frozenV2 · object[]

Delegated frozen balance v2

Show child attributes

undelegated_frozenV2 · object[]

Undelegated frozen balance v2

Show child attributes