wallet/freezebalancev2 | TRON

POST /95e61622bf6a8af293978377718e3b77/wallet/freezebalancev2

wallet/freezebalancev2

cURL

curl --request POST \
  --url https://tron-mainnet.core.chainstack.com/95e61622bf6a8af293978377718e3b77/wallet/freezebalancev2 \
  --header 'Content-Type: application/json' \
  --data '
{
  "owner_address": "41608f8da72479edc7dd921e4c30bb7e7cddbe722e",
  "frozen_balance": 1000000,
  "resource": "BANDWIDTH",
  "visible": false
}
'

200

{
  "visible": true,
  "txID": "<string>",
  "raw_data": {
    "contract": "<array>",
    "ref_block_bytes": "<string>",
    "ref_block_hash": "<string>",
    "expiration": 123,
    "timestamp": 123
  },
  "raw_data_hex": "<string>"
}

TRON API method that stakes TRX for resources using the new staking mechanism. This method freezes TRX tokens to obtain bandwidth or energy resources with improved flexibility, including the ability to unfreeze resources at any time.

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

• owner_address — the address that owns the TRX to freeze (hex format)
• frozen_balance — the amount of TRX to freeze (in sun, where 1 TRX = 1,000,000 sun)
• resource — the resource type to obtain (“BANDWIDTH” or “ENERGY”)
• visible — optional boolean to specify address format (default: false for hex format)

Response

• visible — boolean indicating address format used
• txID — transaction ID hash
• raw_data — raw transaction data object containing freeze contract details
• raw_data_hex — hexadecimal representation of raw transaction data

Use case

The wallet/freezebalancev2 method is used for:

• Staking TRX to obtain bandwidth for free transactions using the new mechanism.
• Freezing TRX to get energy for smart contract execution with improved flexibility.
• Taking advantage of the ability to unfreeze resources without waiting periods.
• Implementing modern TRON staking in wallets and DApps with better resource management.

Body

application/json

owner_address · string · default: 41608f8da72479edc7dd921e4c30bb7e7cddbe722e · required

frozen_balance · integer · default: 1000000 · required

resource · enum<string> · default: BANDWIDTH · required

Available options: BANDWIDTH, ENERGY

visible · boolean · default: false

Response

200 - application/json

Freeze balance v2 transaction

visible · boolean

txID · string

raw_data · object

Show child attributes

raw_data_hex · string